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Getting Started 


Welcome to WordPerfect Shell. 


WordPerfect Shell lets you organize programs and commands into a menu structure for 
easy access. If you run a large number of programs, you can create multiple menu 
windows to group similar programs together. Once you set up a program or command 
on a Shell menu window, you can start the program or execute the command with a 
single keystroke or click of the mouse. 


Shell also acts as a program integrator, letting you switch between programs without 
exiting the current program. Generally, you can keep as many programs resident as your 
computer's memory and hard disk space will allow (a maximum of 40 programs can be 
loaded resident at one time). 


A Clipboard feature is also included in Shell. The Clipboard feature lets you transfer 
information between programs running under Shell (see Using Clipboards later in this 
guide). 


What's in this section? 


Getting Help 

Registering Your Software 

System Requirements 

Installing Shell 

Starting Shell 

Creating Your Initial Menu 

Using the Mouse 

Starting a Program 

Switching Between Programs 
Starting Programs without a Hotkey 
Changing the Default Directory 
Using Screen Save 

Using Screen Lock 

Going to DOS 

Going to Shell 

Viewing Shell's Memory Usage 
Composing with WordPerfect Characters 
Exiting Shell 
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2 Getting Started 


Getting Help 


Using this Guide 


This guide is divided into three parts: Getting Started, task-oriented sections, and 
appendixes. 


Getting Started + Getting Started teaches you the basics of setting up and using 


Shell. 


Task-oriented Sections + Six brief task-oriented sections show vou how to use Shell 
features. 


Appendixes + Five appendixes cover additional information pertinent to Shell. 


README.SHL 


The README.SHL file on disk contains information that was cither unavailable or 
changed since the manual was printed. 


Online Help gives you quick access to documentation and an extensive glossary without 
reaching for a manual. You can access Help wherever you are in the program, including 
glossary information, pull-down menus, and dialog boxes. 


To use Help, simply press the Help key (F1 or F3, depending on your setup). By default, 
Shell uses F1 as the Help key. (The Escape key is used to cancel.) 


If you want to scroll through topics, use the Help index. Most topics in the index 
contain a Route section, which shows you where you can find that particular feature in 
the program. The index also includes jump terms, which you can click for information 
about related topics. For more information about using Online Help, see the Help 
section in the manual for the program Shell is bundled with. 


Calling Customer Support 


If you need assistance beyond what this guide and Online Help can provide, feel free to 
call Customer Support. 


Before calling, be prepared to explain your problem. Try to duplicate it, then write down 


what happened step-by-step. Also, be at your computer and try to have the following 
available: 


* WordPerfect Shell 4.0 User's Guide 


* Original (master) disks for the program Shell is bundled with (Shell is included on 
the disks) 


+ Shell program date (you can display this by choosing Shell Info from the Help menu) 


+ The brand name, type, and model of your computer and mouse 


If you are using the English version of Shell within the United States, U.S. territories, or 
Canada, you can call Customer Support from 7 a.m. to 6 p.m. Mountain time: 


¢ Shell features (including macros) 
*(801) 228-9902 


¢ Using Shell with another WordPerfect Corporation program 


Refer to the Customer Support number listed in the manual for the program Shell is 


bundled with. 
*This number is not toll-free. 


Flectronic Support 

If you have a modem and a communications software package, you can get help 
electronically through the WordPerfect Corporation Bulletin Board Service (BBS). If you 
have a membership to CompuServe, you can get support from the WordPerfect 
Customer Support (WPCS) forum. WordPerfect also offers toll-free electronic support 
for the hearing impaired. For more information about electronic support, see the 
Electronic Support section in the manual for the program Shell is bundled with. 


Registering Your Software 


Take a minute to fill in the registration card for the product Shell is bundled with. Shell 
is covered under that product’s Certificate of License. 


System Requirements 


In order to run Shell, your computer system must have the following minimum 
requirements in addition to the minimum requirements for the program Shell is bundled 
with: 


* 12K to 45K of additional RAM memory 
* 1.1M of available hard disk space for program files 
+ 500K of extended memory, expanded memory, or disk space for swapping programs 


Installing Shell 


Shell is designed to be used on a hard disk or network system. The Shell is installed by 
the WordPerfect Corporation program it is bundled with.. 


To install Shell, 


1 Refer to the installation steps for the WordPerfect Corporation program bundled 
with Shell. 


IMPORTANT: You will be prompted for a destination directory for Shell. If you want 
to update an existing version of Shell, you should update to a directory other than your 
existing Shell directory. After you verify that your new Shell is working well, you can 
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delete your previous Shell files. See Converting Your Shell 3.x Menu File under Creating 
Your Initial Menu \ater in this section for more information. 


Setting the CONAE.SYS File 
The CONFIG.SYS file contains commands that help set up your computer. This file 


must be located in your computer’s root directory. 


You can use WordPerfect, WordPerfect Editor, or another DOS text editor to create or 
edit the CONFIG.SYS file. See your text editor manual for specifics on how to retrieve, 
edit, save, and exit DOS text files. 


Before running Shell, you need to set the FILES= and BUFFERS- commands in the 
CONFIG.SYS file to at least FILES=50 and BUFFERS=20. Because Shell lets you keep 
multiple programs in memory without exiting those programs, cach program can keep 


multiple files open. As a result, you may need to customize the 1:11 |. S= command to 
your particular usage needs. 


Creating and Editing the AUTOENEC.BAT File 
You can set up an AUTOEXEC.BAT file in the root directory on your hard drive or on 
the startup disk in drive A so that Shell is started when you start vour computer. 


You can use WordPerfect, WordPerfect Editor, or another DOS text editor to create or 
edit an AUTOEXEC.BAT file. See your text editor manual for more information. 


You can include the DOS path command in your AUTOEXEC.BAT file (discussed in 
your DOS manual) to have DOS search in specified directories for files to run programs. 
Consequently, you may want to include in your path command all the directories 
containing the program files you will have on the Shell desktop. 


An AUTOEXEC.BAT file might look like the following (if you do not have these 


directories, this example will not work for you): 


path c:\;c:\wp;c:\pr20;c:\shell40 
cd\shell40 
shell 


The cd command located on the line after the path command tells DOS to change to the 
directory where the Shell program is located and make it your default directory. 


The shell command starts the Shell program, so it should be the last command in your 
AUTOEXEC.BAT file. 


Whenever you start a program from Shell, Shell will first search for the program file in the 
default directory you have defined, then in the directory that appears at the upper left 


corner of your Shell desktop (for example, C:\SHELL40), then in each directory in the 
DOS path until it finds the program. 


For those programs not found in a directory searched by Shell as explained above, you 
must include the full path and filename when you define the program. See Entering 
Program Information \ater in this guide for more information about defining a program. 


Starting Shell 


You can start Shell manually ar the DOS prompt (see Starting Shell from DOS below), or 
you can place a command in your AUTOEXEC.BAT file to have your computer start 
Shell for you each time you start the computer. 


IMPORTANT: If you are on a network, your system administrator may have already 
placed the commands in your AUTOEXEC.BAT file necessary to log you in to the 
network and start Shell. In this case, the Shell desktop should appear each time you start 
your computer. You may still want to read Starting Shell from DOS below to understand 
what commands have been executed by your AUTOEXEC.BAT file. 


Loading the Macro Engine (Advanced Macros) 

Shell includes Keystroke macros (.KBM, simple play and record) and Advanced macros 
(.SHM, uses programming commands and variables). You must load the macro engine 
(see step 3 below) when you start Shell if you want to use Advanced macros or if you 
want to use the /m-macroname startup option to play Advanced macros. See Using Shell 
Macros larer in this guide for more information about Shell macros. 


The macro engine uses an additional 30K of conventional memory; however, you can 
load it into upper memory by using the /tsr startup option. To do so, you must use a 
utility designed to load Terminate and Stay Resident (TSR) programs into upper memory 
(for example, loadhigh mc /tsr). If the macro engine is loaded into upper memory, you 
don’t need to load it every time you start Shell. 


Starting Shell trom DOS > 

To start Shell from DOS, 

1 Ifyou are on a network, turn on your computer and log in to the network. 
or 


If you are on a stand-alone machine, start your computer. 
2 Change to the drive and directory that contains the SHELL.EXE file. 


3 Type shell, then press Enter to start Shell. 
or 
Type mc shell to load the macro engine, then press Enter to start Shell. 
If you are on a network and are prompted for your file ID, enter your file ID to start 


Shell. Your file 1D is usually your initials; however, Shell 4.0 lets you enter a five- 
character ID. Ask your system administrator for more information. 


Getting Started $ 


You can retrieve specific 
program types and search 
specific directories. 


You can convert your Shell 3.x 
to the Shell 4.0 format. 


2. Find Shell 3.x Menu Search the DOS Path for a Shell 3.x 
You can retrieve an existing bat 


Shell 3.x or Shell 4.0 to use asa 
pattern. 


You can build a Shell 4.0 
desktop of your own design. 
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Using Command Line Options sf | 
Command line options are commands or startup options that are specific to the program 


you are currently defining (see Program Definition Options in Entering Program 
Information later in this guide). 


Using Shell Startup Options 


Shell startup options are switches you can use to activate, deactivate, Or modify specific 
functions or features when you start Shell (see Appendix E: Shell Startup Options). 


Creating Your Initial Menu 


When you first start Shell, you are prompted to create an initial ment. Choose one of 
the four Getting Started options described below to create your initial menu. 


Getting Started 


Prograns to be run fron WordPerfect Shell 4.0 nust be added to a 
nenu. Select one of the options belou to create an initial nenu. 


Select Option: If you want to: 


1. Select: Prou rans Find and select programs located on 
your systen. 


3. Retrieve Menu File Retricve a Shell 3.x or Shell 4.0 


nenu file. 


4. Create Menu Manual ly Add prograns using options found on 


the ‘Menu’ pulldown. 


Exit Shell 


Using the Select Programs Option 


You can choose which type of programs to display on your Shell desktop with the Select 
Programs option. 


List Prograns 


Progran Type: 
All Programs 

Search Directo| Macros 

(a) Drive C: | Batch files 

L ) DOS Path WordPerfect Products 

L ) Other Dire 


Search... F2 


Program Type Description 


Common Programs Programs you may have that are widely used throughout 
the computer industry 

All Programs Files that have a .EXE or .COM extension 

Macros Files that have the .SHM or .KBM extension in the 


search you choose to perform 


Batch Files Files that have che .BAT extension in the search you 
choose to perform 


WordPerfect Products WordPerfect Corporation programs in the search you 
choose to perform 


Once you select the type of programs to add to your Shell desktop, you can search 
your current drive or the DOS path. You can also perform a custom search by 
specifying which directories you want to search. 


Searching Your Current Drive + To search your current drive for programs or 
commands to add to your Shell desktop, 


1 Choose Select Programs from the Getting Started dialog box. 
Z Select a program type (see table above). 


8 Select Drive X from the Search Directories list box (X represents your current 


drive). 
4 Choose Search. 


Shell searches the entire drive (beginning at the root directory) for the programs or 
commands that match the type you specified, then lists them in the List Programs 
dialog box. 


5 Mark the programs you want to add with an asterisk (*). 


You can also use the arrow keys, Search, or Name Search to quickly find the 
programs you want to add. 


When you have marked all the programs you want to add, 


6 Choose Add to Menu, then type a description (name) for the menu. (Place a 
tilde [7] immediately before the character you want to be the mnemonic, for 
example, ~Macros.) 


7 Choose OK. 


Shell inserts all the marked programs or commands into the menu you just created on 
your Shell desktop. 
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Searching Your DOS Path + To search your DOS path for programs or commands 
to add to your Shell desktop, 


1 Choose Select Programs from the Getting Started dialog box. 

2 Select a program type (see Using the Select Programs Option earlier in this section). 
3 Select DOS Path from the Search Directories list box. 

4 Choose Search. 


Shell searches your current directory and the drives/directorics specified in your DOS 
path for all programs or commands that match the type you specified, then lists them 
in the List Programs dialog box. 


If the “Path not found” error message appears, you may want to exit toa DOS 
prompt and correct your path. See your DOS manual for more information about 


creating a DOS path. 
5 Mark the programs you want to add with an asterisk (*). 


You can also use the arrow keys, Search, or Name Search to quickly find the 
programs you want to add. 


When you have marked all the programs you want to add, 


8 Choose Add to Menu, then type a description (name) for the menu. (Place a 
tilde [~] immediately before the character you want to be the mnemonic, for 
example, “Macros.) 


7 Choose OK. 


Shell inserts all the marked programs or commands into the menu you just created on 


your Shell desktop. 


Performing a Custom Search ¢ To perform a custom search for programs or 
commands to add to your Shell desktop, 


1 Choose Select Programs from the Getting Started dialog box. 


2 Select a program type (see Using the Select Programs Option earlier in this section). 


3 Choose Other Directories from the Search Directories list box. 


Other Directories 


F . Add a Dir... 
Adds the directories in your . DOS Path 
DOS path to the search de 
- Clear List 


L ] Search Subdirectorles 


You can select which directories you want Shell to search. 


4 Choose Add a Dir. 


AddvEdit Directory 


Directory itreesmeuF8) BN (QuickList2h= i F6 [UK | 


5 Type the directory you want added to your search. 


or 


Choose Directory Tree, highlight a directory, then choose Select Directory. 


While viewing the Directory Tree, you can choose Other Drive to search additional 
drives. 


6 Choose OK to add the directory to your search list. 
or 


Skip to step 7 if you added a directory with the Directory Tree. 
7 Repeat steps 4-6 to add more directories to your search. 
8 Select Search Subdirectories if you want your search to include subdirectories. 


9 Choose OK, then choose Search. 


Shell searches the specified directories for the programs or commands that match the 
type you specified, then lists them in the List Programs dialog box. 


10 Mark the programs you want to add with an asterisk (*). 


Getting Started Y 


10 Getting Started 


You can also use the arrow keys, Search, or Name Search to quickly find the 
programs you want to add. 


When you have marked all the programs you want to add, 


x . ý H 
11 Choose Add to Menu, then type a description (name) for the menu. (Place a 
tilde [7] immediately before the character you want to be the mnemonic, for 
example, ~ Macros.) 


12 Choose OK. 


Shell inserts all the marked programs and commands into the menu you Just created 
on your Shell desktop. 


Converting Your Shell 3.x Menu File 
If you have Shell 3.x (or WordPerfect Works 1.0) installed on your machine or network, 
you can convert your current Shell to Shell 4.0. 


Converting Your Default Shell 3.x + You can convert your default Shell 3.x to Shell 4.0. 
1 Choose Find Shell 3.x Menu from the Getting Started dialog box. 


2 If you are on a network, type your three-character file 1D (used for your Shell 
3.x), then press Enter. 


Shell searches your DOS path for a SHELL.FIL file (xxxSHELL.FIL file if you are on 
a network). Shell uses the first SHELL.FIL file it finds. If the SHELL.FIL file is not 


in your DOS path, see Retrieving a Shell Menu File below to retrieve your Shell 3.x 
file. 


Shell inserts the programs and commands from your Shell 3.x menu file into the 
menu you just created on your Shell desktop. 


Converting a Customized 3.x Shell + Once you have created your initial menu, you 
can convert an additional Shell 3.x (other than the default Shell) to Shell 4.0. 


From the Shell 4.0 desktop, 
1 Press Shift+F10. 


2 Choose Add, then enter the pathname of your customized Shell 3.x .FIL file at 
the prompt. 


3 Type the filename for the Shell 4.0 file, then choose OK twice to return to the 
main Shell 4.0 screen. 


4 Press Ctrl+O, highlight the menu you want to open, then choose Select Menu. 


Retrieving a Shell Menu File 

You can retrieve an existing Shell 3.x or Shell 4.0 menu file to format your Shell desktop 
rather than creating your own. Retrieving a Shell menu file is like borrowing a friend’s 
Shell desktop to use as a pattern for creating your own Shell desktop. 


IMPORTANT: Before you retrieve a Shell 4.0 menu file, copy it to a personal directory. 


To retrieve a Shell menu file, you must specify the location of the Shell desktop you want 
to use. 


1 Choose Retrieve Menu File from the Getting Started dialog box. 
2 Type the path and filename of an existing Shell menu file, then choose OK. 
Shell retrieves the specified menu file. 


Creating a Menu Manually 
You can build your own Shell desktop manually by creating an empty menu and then 
adding programs and commands individually. 


1 Choose Create Menu Manually from the Getting Started dialog box. 
2 Type a description (name) for the menu Shell creates for you, then Choose OK. 


An empty menu window appears on your Shell desktop. You can use Insert to add 
programs and commands to the menu window. See Entering Program Information later in 
this guide for more information about adding programs and commands to a menu. 


Using the Mouse 


You can use the mouse to select menu and dialog box options, start programs, and 
manipulate menu windows. 


Setting Up the Mouse 
If you use MOUSE.COM, your mouse is already set up. If your mouse is not set up, 


1 Press Alt+F to activate the File menu. 
Choose Setup from the File menu. 


Choose Mouse, then choose Type. 


a O N 


Choose Auto Select to have Shell select the correct mouse type for you. 
or 


Using the arrow keys, scroll through the list box until your mouse type is highlighted, 
then choose Select. 


Y Choose OK, then choose Close to return to the Shell desktop. 
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Selecting and Dragging 


You can select a menu item, a menu or dialog box option, or a menu window by clicking 
the item or option once with the left mouse button. 


Dragging involves holding down the left mouse button while moving the mouse. You 
can move or size a menu window by dragging its title or border lines, respectively (see 


Customizing Your Shell Desktop larer in this guide). 
Using the Quick Menu 


The quick menu provides a condensed list of menu actions. “To access the quick menu, 
1 Click the right mouse button in any menu window. 


Swapping to Other Programs 


If you are not using MOUSE.COM as your mouse driver, after swapping to another 
program, you may have to reselect your mouse. 


Starting a Program 


If you have a mouse, you can double-click a menu description to activate that program. 
You can also move between items in a Shell menu by pressing Up Arrow (1) or Down 


Asrow (1). You can then press Enter to start the highlighted program. 


You can activate a program or command with the keyboard by using mnemonics. 


Mnemonics are the bolded (or colored) characters placed in the menu description. These 
characters can be letters or numbers. 


You can also start a program without exiting the current program (see Switching Between 
Programs later in this section). 
Changing a Menu Item's Mnemonic Character 


To avoid confusion, you should not assign the same mnemonic character to more than 


one menu item. When you type a mnemonic character that is assigned to more than one 
menu item, the Resolve Mnemonic dialog box appears on your screen. 


Resolve Mnenonic 


Prograns/fienus with Mnemonic: w 
UordPerfect Presentations 


+1. Select 


The Resolve Mnemonic dialog box lists all the menu items assigned to the same 
mnemonic character in the open menu windows. 


To start a program or command from the Resolve Mnemonic dialog box, 
1 Highlight the program or command, then choose Select. 


To change a menu item’s mnemonic character, see Editing the Program Definition in 
Entering Program Information later in this guide. 


Limiting Mnemonics to the Active Window 
If you want mnemonics to appear only in the active window, 


1 Choose Setup from the File menu, then choose Environment. 
2 Select Mnemonics Only in Active Windows. 
3 Choose OK, then choose Close. 


Switching Between Programs 


You can use hotkeys to switch between programs. A hotkey is a specific keystroke that 
includes a number ora letter. If you want to switch to (start) another program without 
exiting the current program, press Ctrl+Alt+hotkey. When you use hotkeys to switch 
between programs, both programs stay resident. 


Changing a Menu Item's Hotkey Character 
To avoid confusion, you should not assign the same hotkey character to more than one 
program. 


If more than onc program has the same hotkey, and none of the programs are resident 
when you press the hotkey, the Resolve Hotkey dialog box is displayed (which lets you 
select a program). If one of the programs is resident, pressing the common hotkey takes 
you directly to that program. If more than one of the programs are resident, repeatedly 
pressing the common hotkey will cycle through the programs. 


For more information about changing a program’s hotkey, see Editing the Program 
Definition in Entering Program Information later in this guide. 


Using Go to Last Program 
You can return from the Shell desktop to the last program you left resident with Go to 
Last Program. 


1 Choose Go to Last Program from the File menu. 


Starting Programs without a Hotkey 
If you cannot remember the hotkey for a program, you can start that program from the 


Resident Programs dialog box. You can also switch to another program on Shell desktop 
from within the current program. 
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Switching to a Resident Program 
To switch to a resident program from within another program, 


1 Press Ctrl+Alt+Esc, highlight a program, then choose Select. 


starting a Non-Resident Program 
To start a program that is not currently resident, 


1 Press Ctrl+Alt+Esc, then choose Shell Menus. 
The programs on the current menu are listed in the Menu Contents list box. 
2 Highlight the program, then choose Run. 


Because non-resident programs are not automatically grouped together like resident 
programs, you may need to specify a menu before you can start the program. 


If the program you want to start is not listed, 


3 Highlight the appropriate menu in the Menu Tree list box, highlight the program, 


then choose Run. 


Changing the Default Directory 


The name of the directory you are in when you start Shell is displayed in the upper left 
corner of the Shell screen. This is the default directory for Shell. 


To change the Shell default directory, 

1 Choose Other Directory from the File menu. 

2 Type the full path of the new default directory (such as c:\shell40) at the prompt. 
or 


Choose Directory Tree, highlight a directory, then choose Select Directory. 


While viewing the Directory Tree, you can choose Other Drive to move to 
additional drives from which to select a new default directory. 


3 Choose OK. 


Using Screen Save 


Leaving the same screen displayed for long periods of time can leave a ghost of that image 
etched in the monitor screen. Screen Save protects your monitor from such damage. 
Screen Save causes the screen to go blank if no keys are pressed (or the mouse is nor 
moved if you are using MOUSE.COM) within a specified time period. Screen Save 
works in Shell and in most programs you start from Shell. It also works in all text and 
most graphics modes. 


IMPORTANT: Screen Save does not work in a CGA graphics mode. Also, it is not 
uncommon with some Hercules-compatible graphics cards to see a thin line at the top of 
the screen when Screen Save makes the screen go blank. This is necessary to protect these 
graphics cards. 


To change the Screen Save setting, 

1 Select Setup from the File menu, then choose Environment. 

2 Select Screen Save, then specify the number of minutes (1 to 60) you want to elapse 
before the screen gocs blank. 


or 


Specify 0 (zero) to turn off Screen Save. (This is the default setting.) 
3 Choose OK, then choose Close. 


Restoring the Screen 

When Screen Save causes the screen to go blank, you can press Ctrl, Alt, or Shift to 
restore the screen. The key you press turns off Screen Save and is also executed. If only a 
portion of the screen is restored, turn off the Screen Save feature. Screen Save does not 
work with some Hercules-compatible graphics cards. 


Using Screen Lock 


When you leave your desk, you can use Screen Lock to prevent unauthorized use of your 
computer. You can also use Screen Lock to tell others where you are and/or when you 
will be back, and provide a way for others to leave a message for you in your absence. 


Assigning a Password 
To assign your Screen Lock password, 


1 Choose Setup from the File menu, then choose Environment. 
2 Choose Screen Lock Password, 


3 Type a password, press Enter, then type the same password again to verify that you 
have not made any typing errors. 


d Press Enter. 


Creating a Default Message 
To create a message that will appear each time you use Screen Lock, 


1 Choose Setup from the File menu, then choose Environment. 


2 Choose Screen Lock Message, choose Text, then type a message (for example, “Gone 
to a meeting”). 


If you want to enable others to leave messages for you while you are away, 
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3 Choose Allow Messages, choose OK twice, then choose Close to return to the Shell 
desktop. 


Using Screen Lock 


If you have not specified a directory for your personal message board, see Serting Up Your 
Message Boardsin Using a Message Board \ater in this guide. 


Before leaving your desk, 
1 Choose Screen Lock from the Tools menu, type your password, then choose OK. 


2 Verify the default message, then choose Allow Messages. 


or 


Choose Text, type a message, then choose Allow Messages. 


3 Choose OK. 


The messages left for you are stored in the personal Message Board directory you specify. 


Going to DOS 
To go to a DOS prompt without exiting Shell, 


1 Choose Go to DOS from the File menu, then choose Go to DOS from the DOS 
dialog box. 


A copy of DOS is started, and any resident programs stay resident. 
2 Type exit ar the DOS prompt, then press Enter to return to Shell. 
To execute a DOS command without exiting Shell, 


1 Choose Go to DOS from the File menu, then choose DOS Command from the 
DOS dialog box. 


2 Type the DOS command you want to execute, then press Enter. 


8 Press any key to return to Shell. 


Going to Shell 


Once you start a program from a Shell menu window, you can return to Shell without 
exiting the current program. 


To go to Shell ftom any program running under Shell, 
1 Press Ctrl+Alt+Space. 


Programs list box 


Visste yes 2 a Menory Usage Tp hea ee l 
re Bee si Available Bytes ——L— 


If you do not go to Shell when you press Ctrl+Alt+Space, you may need to create a Go to 
Shell macro, or you may have checked the Disable Shell Hotkeys option. (These features 
are described in Program Definition Options under Entering Program Information later in 
this guide.) Or, your program may be running in a non-standard graphics mode. 


In a Shell menu window, an asterisk (*) appears next to the menu description of the 
program you just left, indicating that the program is resident. You can now start another 
program from the Shell menu window or select any of the Shell features. 


To return to the program you left resident, 

2 Return to the Shell menu window containing the program, then choose that 
program. 
or 


Press the hotkey of the program by using Ctrl+Alt+hotkey. For example, if P were the 
hotkey character for WordPerfect, you would press Ctrl+Alt+P. 


or 
Press the mnemonic of the program. 
The mnemonic and hotkey do not need to be the same character as in earlier versions of 


Shell. For example, the mnemonic for WordPerfect may be W while the hotkey could be 
Ctrl+Alt+P 


You can also return to an active program from many programs running under Shell by 
pressing Ctrl+Alt+Esc, then selecting the program. 


Viewing Shell's Memory Usage 
From the Shell desktop, 


1 Choose Memory Usage from the Tools menu. 


Available memory 


CONU 591,440 
Ens 0 
XMS 2,968,576 


D: Drive 2,079,744 


(C) - Conventional Menary 
(E) - Expanded Memory 

00 - Extended Menory 
(D) - Suapped to Disk 


Any resident programs are listed by name in the Programs list box. Programs or device 
drivers loaded into memory before you started Shell may appear as (Unknown) on the 
list. 
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Shell can use disk, extended, and expanded memory to swap programs. An E appears 
next to any program currently swapped to expanded memory, and a D appears next to 
any program currently swapped to disk. An X appears next to any program currently 
swapped to extended memory. A C appears next to any program currently active in 
conventional memory. 


The amount of available memory is displayed in the upper right corner of the dialog box. 
You can see the available bytes on the disk you specified for temporary files (or on the 
default disk if you didn't specify a directory). Using the available memory information 
and the approximate memory specifications for the programs you usc. you can determine 
which combinations of programs you can have resident at the same time. 


Any External Launcher Drivers (ELD) that are loaded will also appear in the memory 
usage dialog box. ELDs are programs that provide additional features for Shell (for 


example, Clipboard and Screen Swapper). When ELDs are found, they are loaded with 
SHELL.EXE automatically. 


2 Aher viewing the Memory Usage dialog box, choose Close to return to the Shell 
desktop. 


For more information on how Shell uses memory, see Appendix B: Memory Usage. 


Composing with WordPerfect Characters 


You can use WordPerfect Characters in most dialog text fields (for example, Program 
Description, Menu Description, and various Message Board fields). 


1 Select a text field in a dialog box, then press Ctrl+w. 
2 Select Set, then choose a Character Ser. 


3 Select a character, then choose Insert. 


Exiting Shell 
To exit Shell and rerurn to DOS, 
1 Choose Exit from the File menu. 


If you have already exited all the programs you started from Shell, you are asked to 
confirm that you want to exit Shell. 


2 Choose Yes to exit Shell. 
or 


Choose No to return to Shell. 


If you exit Shell from a menu window that contains resident programs, Shell asks whether 
you want to exit the current menu or all menus and whether you want to save the 
program information in the menus. 


If, when you exit Shell, you have resident programs that are not in the active menu 
window, Shell asks only whether to save the program information in the menus. 


3 Choose Current Menu or All from the Programs to Exit group box to specify which 


menu(s) you want to exit. 
or 


Skip to step 4. 


4 Choose Save or No Save from the Program Information box to specify whether the 
information in the programs you are exiting will be saved. (This affects only Shell- 
aware programs.) 


If you chose to save all currently active files in step 4 above, Shell goes to each resident 
program, starting with the first-started program. If the file has been modified in a Shell- 
aware program, the program prompts you for a filename to save the file. After you save 
the files, the program is exited and Shell moves to the next resident program (if any). If 
the file has not been modified or if it is a program in which you cannot modify a file 
(such as File Manager), the program is exited for you. 


If you are exiting a program that is not Shell-aware, you must manually exit che program, 
saving any necessary information. Marking the 3.x Compatibility box for programs that 
are Shell 3.x-aware will allow them to exit automatically. See Execution Options under 
Program Definition Options in Entering Program Information later in this guide for more 
information. 


If you decide not to save an active file, you can press Esc or F1 when prompted for a 
filename, then exit the program as you normally would. As soon as you exit that 
program, Shell continues the exiting process. 


After all programs have been exited, you are asked if you want to exit Shell. 
To confirm that you want to exit Shell, 


5 Choose Yes to exit Shell. 
or 


Choose No to return to Shell. 
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Customizing Your Shell Desktop 


When you start Shell for the first time (or convert your Shell 3.x to Shell 4.0), the default 
configuration appears on your screen. 


Shell includes various options for manipulating the Shell menu windows and changing 
the default settings for several Shell features. 


Whar’s in this section? 


Adding a Menu 

Editing a Menu 

Deleting a Menu 

Customizing a Window 

Changing the Desktop Color Scheme 
Displaying the Shell System Windows 
Selecting Menu Files 

Saving Your Desktop Layout 


oe ¢ © 4. +% . © 


Adding a Menu 
To add a submenu to an active menu, 
1 Choose Add Item(s) from the Menu menu. 


2 Choose Menu from the Menu Item Type group box. 


== Henu Options = 
1. Menu Description... 


Z. L 1 Always Open 
3. [ J Start Programs Resident 


OK cence | 


3 Choose Menu Description. 


4 Type the description (title) of the menu. (Place a tilde [7] in front of the character 
you want to become a mnemonic, for example, ~Macros.) 


Y Choose OK. 

If you want the menu to remain on screen at all times, you can select Always Open. 
You can also set the menu to start resident by selecting Start Programs Resident. 

By selecting Start Programs Resident, every program on that submenu will start resident 


even though the individual programs on that menu are not marked to start resident. This 
does not affect whether that menu is visible when you start Shell. For example, if you 
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have a menu called MY MENU, and you have WordPerfect, WordPerfect Presentations, 
and WordPerfect Office on that menu, all three programs will be loaded into memory the 
next time you start Shell if MY MENU is marked to start resident. 


This feature makes it easy to start certain programs resident every time you start your 
computer. After they are loaded, you are returned to the Shell desktop. 


When you create or edit a menu, you can also include a help message to assist others who 
will be using the menu. 


To create a menu help message, 

6 Choose “About Item” Text. 

7 Type the message, then choose Close to exit the About Menu Item dialog box. 
8 Choose OK. 


Accessing a Menu Help Message 
To access a menu help message, 


1 Select a menu, then choose About Menu Item from the Help menu. 


You can choose Close to return to the menu. 


Editing a Menu 
To edit a menu, 


1 Select a menu window, then choose Menu Options from the Menu menu. 
or 


If the menu you want to edit is closed, open the menu, then choose Menu Options 
from the Menu menu (see Opening a Menu Window below). 


The Menu Options dialog box appears. You can change any of the settings to customize 
the menu to your needs. For more information about changing the Menu Options 
settings, see Adding a Menu earlier in this section. 


2 Choose OK. 


Deleting a Menu 
To delete a menu, 
1 Highlight the description of the menu you want to delete. 


2 Choose Delete from the Menu menu. 
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IMPORTANT: All items (including programs) in this menu and its submenus will be 
deleted. 


3 Choose Delete. 


If you delete a menu accidentally, or want to recover the last deletion, you can choose 
Undelete from the Menu menu, then choose Undelete again. You can undelete only the 
last item you deleted. 


Customizing a Window 


The sections below describe features included with Shell that you can use to manipulate 
and customize windows. 


Opening a Menu Window 
To open a menu that is listed in a menu window, 


1 Highlight the menu description, then press Enter. 
or 


If all menu windows are closed, or if the menu you want to open is a submenu ina 
menu that is closed, choose Go To Menu from the Menu menu, highlight che menu 
you want to open, then choose Select Menu. 


You can have as many as 12 windows open at a time. 


Closing a Menu Window 
To close a menu window, 


1 Click the Close button at the upper left corner of the menu window. (You can also 
select the menu you want to close, then choose Close from the Window menu.) 


Close Button ——___ une OTT 


Moving a Window 


To move a window, 


1 Place the mouse pointer on the title line of a window and drag the window to its new 
position. (You can also choose Move/Size from the Window menu, use the arrow 
keys to move the window, then press Enter when finished.) 


Moving a Menu Item to Another Menu Window + To move a menu item to 
another menu window, 


1 Select the menu item you want to move. 
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2 Choose Move from the Menu menu, then choose Change Destination Menu. 
3 Highlight a menu description, then choose Select Menu. 


4 If the destination menu is not empty, drag the new menu item to the position 
you want it in the menu, then choose OK. 


The menu item is inserted into the destination menu. 


Sizing a Window 
You can use a variety of techniques to size a window. To manually size a window, 


1 Place the mouse pointer on either side border line or the bottom border line and 
drag. (You can also choose Move/Size from the Window menu, use Ctrl+arrow keys 
to size the window, then press Enter when finished.) 


You can also size a window using Maximize (4) and Minimize (7). 
To maximize a window (enlarge it to fill the screen), 


1 Click Maximize (4) at the top right corner of the window. (You can also choose 
Maximize from the Window menu.) 


To return the window to its previous size, 


2 Click the double arrow at the top right corner of the window. (You can also choose 
Restore from the Window menu.) 


To minimize a window (reduce it to an icon), 


1 Click Minimize (Y) at the top right corner of the window. (You can also choose 
Minimize from the Window menu.) 


To restore the window to its previous size, 


2 Click the middle of the menu icon. (You can also choose Restore from the Window 
menu.) 


You can also press Ctrl-1 or Cerl-! to maximize/minimize/restore a window, depending 
on the current size of the window. 


Arranging Windows 

You can use Tile and Cascade to arrange as many as nine windows on screen at the same 
time. Tile organizes the windows on screen so that they do not overlap each other. 
Cascade organizes the windows so that they overlap with a portion of each window 
visible. 


To tile your windows, 


1 Choose Tile from the Window menu. 
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To cascade your windows, 


2 Choose Cascade from the Window menu. 


Changing the Desktop Color Scheme 


You can change the desktop color scheme to one of the four color schemes included with 
Shell, or you can create your own. 


To change the color scheme to one included with Shell, 


1 Choose Setup from the File menu, then choose Display. 


Display 


Color Schemes list box ——————- lor 

[Gettysburg] 
[Vinter Wonderland] 
[UP Default] 


2 Highlight a color scheme in the Color Schemes list box, then choose Select. 
3 Choose Close to exit the Setup dialog box. 

The Shell desktop displays the new color scheme. 

To create your own color scheme, 

1 Choose Setup from the File menu, then choose Display. 

2 Choose Create, type the name of your new color scheme, then choose OK. 
3 Select Windows or Dialogs in the Colors To Edit list box, then choose Attributes. 
4 Highlight an attribute you want to change, then choose Color. 

The Select Color dialog box appears on your screen. 

5 Choose the color attributes you want with the arrow keys, then choose OK. 
8 Repeat steps 3 through 5 to change the remaining attributes. 


7 Choose OK, choose Select, then choose Close. 
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Displaying the Shell System Windows 


Shell includes two system windows to help you organize information while working 
under Shell. The system windows are available from the Window menu. 


Window List 

Window List shows all the windows that are currently open. Sometimes windows will be 
stacked on each other. Rather than sifting through the stack of windows to find the one 
you want, you can choose a window (menu) title in the Window List to activate that 
window and bring it to the front. 


Resident Programs 
Resident Programs lists all the programs that are resident in memory. You can choose a 
program description to switch to that program from Shell. 


Selecting Menu Files 


You can use Menu files to customize your Shell desktop. You can quickly add or remove 
menu windows from your desktop by adding or removing menu files. 


Adding a Menu File 
To add a menu file, 


1 Choose Menu Files from the Menu menu, then choose Add. 


2 Type the path and filename of the menu file you want to add to the menu file list. 


8 Choose OK. 
or 


If you are creating a new menu file, choose Yes, type a description for the new menu, 


then choose OK. 


Removing a Menu File 
To remove a menu file, 


1 Choose Menu Files from the Menu menu, highlight a menu file, then choose 
Remove. 


The menu file is removed from the list. 
2 Choose OK. 


Copying a Menu File 
To copy a menu file, 


1 Choose Menu Files from the Menu menu, highlight a menu, then choose Save As. 


2 Type the new filename for the menu file, then choose OK. 
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The menu file is not displayed unless you add it to the Menu Files list (see Adding a 
Menu File above). 


Saving Your Desktop Layout 
To save your desktop layout, 


1 Choose Save Layout from the Window menu to immediately save your desktop 
layout. 


or 


Choose Save Layout on Exit from the Window menu to have Shell save your desktop 
layout every time you exit Shell. 
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Entering Program Information 


When you add a program or command to a Shell menu window, you must enter the 
information Shell needs to display the item on the menu window and to execute the 
program or command when you select that item. 

What's in this section? 


* Adding a Menu Item 

+ Editing the Program Definition 

° Deleting a Menu Item 

> Program Definition Options (for Advanced Users) 


Adding a Menu Item 
To add a menu item, 


1 Choose Add Item(s) from the Menu menu, then choose Program from the Menu 
Item Type group box. 


= Define Progran 


1. Description... 
2. Filenane: 
3. Directories: 
Default: 
Macros: 
- Type S. HotKey... 
(1) Normal 


L ) DOS/Batch 6. Advanced Options... 
L ) Macro 


Directory Tree... F8 File List... FS OK 


2 Choose Description, then type the description (name) of the menu item, (for 
example, WordPerfect). 


You should give the menu item a name you will readily recognize. Place a tilde (^) 
immediately before the character you want as the mnemonic (usually the same character 
as the hotkey). 


3 Choose OK. 
4 Choose Filename, then type the path and filename (for example, ¢:\wp5 1\wp.exe). 


B Choose Directories, type the default directory for the program or command (for 
example, c:\wp51), then press Enter. 


6 Type the path to the directory where you want to store the Shell macros you will be 
using for this program. 
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7 Choose Type, then select the appropriate entry type for the program or command 
(for example, Normal). 


IMPORTANT: You must select DOS/Batch when adding a batch file to prevent a 
system lockup when you run that item. 


B Choose Hotkey, then choose a character from the HotKey Assignment dialog box 
(for example, W). 


9 Choose OK. 


Using List Programs 
You can quickly add several programs to a menu window with List Programs. 


1 Choose Add Item(s) from the Menu menu, then choose List Programs. 


2 Select a program type, then select a search type. See (Creating Your Initial Menu in 
Getting Started.) 


3 Choose Search. 


Shell performs the search you selected and lists the specified programs or commands in 
the List Programs dialog box. 


4 Mark the programs you want to add with an asterisk (*). 

You can use the arrow keys, Search, or Name Search to find programs you want to add. 
5 When you have marked all the programs you want to add, choose Add to Menu. 
Shell inserts all the marked programs or commands into the menu window. 

Editing the Program Definition 


To edit a program or command you have added to a Shell menu window, 


1 Highlight the menu item that you want to edit, then choose Edit Item from the 
Menu menu. 


2 Refer to steps 2 through 9 listed above in Adding a Menu Item to edit the program or 


command. 


From the Define Program dialog box, you can press PgUp or PgDn to move to the 
previous or next menu item. 
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Deleting a Menu item 

To delete a menu item, 

1 Highlight the description of the menu item you want to delete. 
2 Choose Delete from the Menu menu, then choose Delete. 


If you delete a menu item accidentally, or want to recover the last deletion, you can 
choose Undelete from the Menu menu, then choose Undelete again. You can undelete 
only the last item you deleted. 


Program Definition Options (for Advanced Users) 


When you add a program or command to a Shell menu window, you can specify various 
advanced information options. 


To edit a program or command with the advanced options, 


1 Highlight the menu item that you want to edit, choose Edit Item from the Menu 
menu, then choose Advanced Options. 


1. Command Line Options: 
2. Preloaded Commands 


[ade 


. futonatic Macros 
End of Line Go to: Return: 


2 Select the options you want to edit, enter the appropriate information (the Advanced 
Options are described below), then choose OK twice to return to the Shell desktop. 


Command Line Options 
You can use command line options to include startup options for a program or parameters for a 
DOS command. The Command Line Options line can contain as many as 128 characters. 


Shell Preset Commands 
Shell includes three preset commands. These commands let you customize startup 
options and preloaded commands. Each command is explained below. 


Shell Preset Commands Descriptions 


2" prompt: " Prompts for command line option 
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Shell Preset Commands Descriptions 


2% DOS variable% Inserts the value of a DOS environment variable 
%% Inserts program filename and startup options 


Using ?"prompt: " + A command line option prompt reminds you to enter a 


customized startup option each time you start the program. 
To create a prompt on the Command Line Options line, 


1 Select Command Line Options. 


or 


Choose OK to return to the Define Program dialog box, then select Filename. 


2 Type a question mark (?) followed by the text of the prompt in quotation marks 


U) 


For example, to execute a variety of macros when starting WordPerfect, you could 
enter /m-?"Macro Name:” on the Command Line Options line. “hen whenever you 
start WordPerfect from a Shell menu, Shell pauses, displays the “Macro Name:” 
prompt, and waits for you to enter a macro name. As soon as you press Enter, the 
startup process continues. If you create the prompt in the Filename field, you should 
separate each word with a backslash (1) (no spaces). 


Using ?%DOS variable% + You can insert DOS variable values as the path to your 
executable file, or for your default or macro directories. 


To insert a DOS environment variable value, 


1 Choose OK to return to the Define Program dialog box, then select Filename, 
Default Directories, or Macro Directories. 


or 


Select Advanced Options, then select Command Line Options. 


2 Type a question mark (?) followed by the DOS variable enclosed in percentage 
signs. For example, if you had set the DOS variable, 
SET WORDPROC=C:\WP5 I\WWPEXE, you would type ?%wordproc%. 


3 Press Enter, then choose OK. 

Using %% + To insert the program filename and startup options, 
1 Select Preloaded Commands. 

2 Type the filenames for the programs you want to preload. 
Each command must be on a separate line. 


8 Press Enter, then type %%. 


If you want to execute commands when you exit the program, 
4 Enter each command you want executed on a separate line after the %%. 


Preloaded Commands 

Preloaded commands are those commands you execute before you start a program. 
Preloaded commands allow you to temporarily load and unload Terminate and Stay 
Resident (TSR) programs with a program. TSR programs are often created to add 


functionality or features to another program. 


You can run any TSR program by starting the program before you start Shell. When you 
do so, however, the TSR program remains resident in memory, and the memory it uses is 
never available for use by other programs. 


You can eliminate this memory problem by using preloaded commands. Shell lets you 
switch to TSR programs just like you would switch to any other program running under 
Shell (see Switching Between Programs in Getting Started). When you switch out of a TSR 
program started with a preloaded command, the TSR program is suspended and swapped 
out to expanded memory or disk. This disables the TSR program’s hotkeys and frees up 
memory for use by other programs. 


For example, you can preload WordPerfect Rhymer before you start WordPerfect. 
To create a preloaded command, 


1 Select Preloaded Commands. 


2 Type the command(s) you want preloaded. (For example, you can type rhyme.com 


to preload WordPerfect Rhymer.) 


A soft return in the Preloaded Commands text box is treated as a space. 


Preloading Batch Files + Shell creates a batch file from the preloaded commands. 
Because DOS terminates execution after running one batch file, if you include a batch file 
as a preloaded command, you will also need to place the CALL command before the 
batch filename. If your DOS version does not support the CALL command in batch 
files, you can include the contents of the batch file as a preloaded command. 


Execution Options 

When you start a program from Shell, you can control how the program will be executed. 
When you select execution options for a program, those options will go into effect every 
time you execute that program. Each of the execution options is described below. 


To select execution options, 
1 Choose Execution Options. 
2 Select the appropriate execution options. 


Prompt for Command Line + If you select the “Prompt for Command Line” 
option, Shell displays the “Options:” prompt each time you start chat program. Shell 
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then waits for you to enter command line options (as many as 128 characters). The 
startup process continues as soon as you press Enter. 


Pause after Exit * You can use this option to display the “Press any key to 
continue...” message when you exit a program. Pause after Exit is useful when 
executing a DOS command or other program that displays text on screen and exits 
when completed (for example, chkdsk or mapmem). The pause lets you see what was 
displayed before the Shell menu is redisplayed. 


Disable Shell Hotkeys ¢ This prevents you from using hotkeys to swap programs. 


Shell 3.0 Compatibility + This allows programs that are Shell 3.x compatible (such 
as older versions of WordPerfect Corporation products) to run with and interact with 
Shell 4.0. SHL_CMPEXE must be installed in the same directory as SHELL.EXE 


for this feature to work. 


Start Resident + If you select the “Start Resident” option, the item is loaded into 
memory each time you start Shell. 


Shell-aware programs will return control to Shell on initial load if you specify Start 
Resident. Programs that are not Shell-aware will be interrupted by Shell and forced 
to return control to Shell. When a program that is not Shell-aware is set to start 
resident, Shell forces it to swap back to Shell unless it cannot swap the program (due 
to incompatible graphics mode, not enough memory to swap, and so on). 


Environment Size (for DOS commands and batch files only) + You can increase 
the DOS environment size for batch files with this option. See your DOS manual 
for more information about the DOS environment. 


Automatic Macros 
Three preset macros are listed in the Options dialog box: End of Line, Go to (Go to 
Shell), and Return (Return from Shell). If you decide you need to use any of these 


macros (see their descriptions below), you must insert your own macro names in the fields 
provided in the Automatic Macros box. 


To insert a macro name, 


1 
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Select End of Line from the Automatic Macros box, then type the macro name (as 
many as eight characters). 


Repeat step 1 to insert a macro name for the Go to and Return macros, then choose OK. 


Defining an End of Line Macro ¢ You can use the End of Line macro to add 
specific characters to the end of each text line when you use Screen Paste in a 
particular program. See Pasting from a Clipboardin Using Clipboards for information 
on Screen Paste. This macro must be defined from within the program. 


To define an End of Line macro, 


1 Press Cerl+Shift+F10. 


If the macro engine (MC.EXE) is loaded, this keystroke will define a .SHM macro. 


2 


If the macro engine is not loaded, press Ctrl+Alt+F1, then choose Macro Define 
to define a .KBM (keyboard) macro. 


Type the macro name, then press Enter. 
Type the macro description, then press Enter. 


Execute the keystrokes for any characters you want added to the end of each line 
when you use Screen Paste (for example, Tab or Hard Page). 


Press Ctrl+Shift+F10 to save a SHM macro. 
or 


Press Ctrl+Alt+F1, then choose Define Terminate to save a .KBM macro. 


Defining a Go to Shell Macro + If the hotkeys don’t work in a program, try using a 
Go to Shell macro. This macro must be defined from within the program. 


IMPORTANT: Your program must have an option for going to DOS or executing a 
single DOS command without exiting the program in order for a Go to Shell macro 
to work. 


To define a Go to macro, 


1 


Press Cerl+Shift+F10. 


If the macro engine (MC.EXE) is loaded, this keystroke will define a SHM macro. 


2 


If the macro engine is not loaded, press Ctrl+Alt+F1, then choose Macro Define 
to define a .KBM (keyboard) macro. 


Type the macro name, then press Enter. 


Execute the keystrokes that take you to DOS or let you execute a single DOS 
command, 


If you are taken to a DOS prompt, type e:\path\shelldos to return to Shell (where 
path is the path to your SHELL.EXE directory). 


8 Dress Ctrl+Shift+F10 to save a .SHM macro. 


or 


Press Ctrl+Alt+Fl, then choose Define Terminate to save a KBM macro. 


Defining a Go to Shell macro for a program is usually sufficient to make the hotkeys 
work. However, a Return from Shell macro is necessary for some programs. 


Defining a Return from Shell Macro + You need to define a Return from Shell 
macro for a program if you cannot return directly to the program by simply selecting 
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that program from a Shell menu. For example, some programs return you to DOS, 
where you must enter an additional command to return to the program. This macro 


must be defined from Shell. 

To define a Return macro, 

1 Press Ctrl+Shift+F10. 

If the macro engine (MC.EXE) is loaded, this keystroke will defino a .SHM macro. 


2 Ifthe macro engine is not loaded, press Ctrl+Ale+Fl, then choose Macro Define 


to define a .KBM (keyboard) macro. 
3 Type the macro name, then press Enter. 


4 Execute the keystrokes you would normally press to return to the program from 


DOS. 
B Dress Ctrl+Shift+F10 to save the macro. 
or 
Press Curl+Alt+F1, then choose Define Terminate to save a KBM macro. 


Password 


You can assign a password for each program or command you add to a Shell menu. Once 
you assign a password, you cannot start the program or execute the command without 
knowing the password. You must also know the password to edit the menu item. 


To enter a password, 
1 Choose Password, then enter a password twice. 


You can use as many as 11 characters in your password. Because the password does not 
appear on the screen, you are prompted to enter the password twice to prevent you from 
making a typing error and unintentionally creating an unrecognizable password. 


"About item’ Text 


When you create or edit a menu item, you can also include a help message to assist others 
who will be using the program or command. 


To create a program help message, 
1 Choose ‘About Item’ Text. 
2 Type the message, then choose Close. 


8 Choose OK twice to return to your Shell desktop. 
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Using File Manager 


File Manager helps you find, organize, copy, and otherwise manage your files without 
your having to return to DOS. 


—— RARO File Manager Lonnie | A 
Current directory | T E pora 04/16/53 03:289-y — Date and time 
psor ena 
1 


(e arent <Dir>) 


How files are listed <Dir> 
| OFSOGARC. <Dir> 04/07/93 
A subdirectory in the current ———(| ELD-CLIP.EXE 22,736 04/13/33 


directory 


Scroll bar 
. Sort by... 


. Change Default Dir... 
- Current Dir... FS 


+ Search... FZ 


7 
B 
9 
F. Find... 
E 
N. Nane Search 


Number of files in the directory 


= (Un)nark 
Honc,» (Un)mark All 


Free disk space; disk space 


used by this directory 


File size in bytes Date and time file was last 
saved 


You can save hundreds of files on a hard disk, which works like a large filing cabinet. To 
group similar files, you can create “file drawers” called directories. 


The default directory is the one Shell uses for file operation, unless you specify another 
directory. 


A pathname includes the drive letter, directory, and filename where the file is stored. For 
example, c:\sheli40\shell.exe represents the file “shell.exe” in the “shell40” directory on 
drive letter “c”. 


If you need more information about directories, paths, or filenaming, see your DOS manual. 


What’s in this section? 
Displaying a Directory 
Creating a New Directory 
Sorting the File List 
Selecting Files 

Looking at a File 

+ Copying a File 

* Moving/Renaming Files 

* Deleting a File 
+ 


+e ... 2. 


+ 


Using QuickList 
Using the Directory Tree 
+ Setting Up File Manager 
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Displaying a Directory 
You can display any directory in File Manager. 
1 Choose File Manager from the File menu. 


2 Choose OK to view the default directory. 


or 


Type the directory you want to view in the Directory text box, then choose OK. 
Creating a New Directory 
To create a new directory, 
1 Choose Other Directory from the File Menu. 
2 Type the new directory you want Shell to create, choose OK, then choose Yes. 
Sorting the File List 


Normally the file list is arranged alphabetically by filename, but you can also sort it by 
extension, date, or size. 


1 Choose File Manager from the File menu, specify a directory, then choose OK. 
2 Choose Sort by. 


3 Select the options you want, then choose OK. See the illustration below for a 
description of the options. 


Sort by filename Laia leel 
IS ol Sort by size 
Sort alphabetically by extension — 1 ) 


a) Kc [| 
(.COM, .WPG, and so on) | | E eb aii 


Sort by date/time saved 
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O) to sort ——— — No Sort; makes File Manager list 


files faster 
2. L J Descending Sort: L A 
NH Sort in descending order 
m 


Selecting Files 


When you highlight a file, you can select its name to fill in a file/parhname selection 


dialog. 


1 Choose File Manager from the File Menu, specify a directory, then choose OK. 


To select a single file, 


2 Click the file to highlight it. (You can also use Up Arrow (1) or Down Arrow (1) to 
highlight the file). Then choose (Un)mark. 


To select multiple files, 


3 Move to each file, then choose (Un)mark. (Un)mark All lets you mark or unmark all 
files in the current directory. 


Using Find, Search, and Name Search 
If the current directory contains many files, you may want to use Find, Search, or Name 
Search to quickly find the file(s) you want. 


Use Find to locate files by specifying filenames or a word or phrase found in the files. 


1 Choose Find from File Manager, then choose one of the Find Options. 


Choose Name to find a specific RR Ss Find 
1. Nare... 


filename pattern 


Choose Word to find a specific 
word pattern within a file 


2. Word... 


| 3. Undo... 


Choose Undo to annul the last 
level of your search 


To search for an exact phrase in a word search, include a space between the last letter and 
the last quotation mark. If an actual phrase contains a single quotation mark, use double 
quotation marks around the phrase. 


To find out how you can make your Find operations more specific, see Specifying Patterns 
in Filenames and Specifying Patterns in File Text below. 


Use Search to quickly locate a single file or directory. Search lets you find a file even if 
you don’t know the entire filename. 


1 Choose Search. 


2 Type a word, a word pattern, or a phrase found in the filename, type, or subdirectory 
name of the file you want. See Specifying Patterns in Filenames below. 


3 If you want to search backward through the list of files, select Backward Search. 
4 Choose Search. 
Search finds the first occurrence of the word pattern in a filename. 


Name Search lets you select a file by typing the first few characters in its name. 
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1 Choose Name Search, then start typing the filename in the Name Search text box. 
When you've typed enough characters for File Manager to find the file, it is selected. 
2 Dress Enter to turn off Name Search. 


Using Wildcards 

You can use wildcards to find files with similar filenames or files that contain the same 
words or phrases. A wildcard can be an asterisk (*) or a question mark (2). An asterisk (*) 
stands for 0 or more characters, while a question mark (?) stands for exactly one character. 


Specifying Patterns in Alenames 


You can display files with similar filenames by typing a file pattern that contains wildcards 
when you use Find or Search in File Manager. 


For example, typing c:\files\*.kbm would display all files with a .KBM extension. Typing 
c:\???sales would display those filenames beginning with any three characters, followed by 


SALES. 
Specifying Patterns in File Text 


The following list gives some examples of Find patterns. Some of them include 
wildcards. 


Pattern Shell finds 
book Files containing the word “book.” 
d?sk 


Files containing words that match the d¿sk pattern (for example, 


desk, disk, dusk). 


“replace disk” Files containing the exact phrase “replace disk.” 

“replace disk*” Files containing patterns such as “replace disks” and “replace 
diskette.” 

“replace*disk” “replace and disk”, “ replace a file on the disk” 


You can also combine words with the following logical operators: the semicolon (;), the 
space ( ), the comma (,), and the dash (-). The semicolon (;) or space () selects files 
containing both words it joins. The comma (,) selects files containing either word it 
joins. When you type a dash (-), Shell excludes all files matching any pattern that follows 
the dash. To search for an actual dash (-), enclose the dash within quotation marks (for 


con 


example, “—”). 


Pathname 


File Format 


The following list gives a few examples of using logical operators: 


Operator Shell finds 

Bill Sue All files containing both Bill and Sue. 

Bill,Sue All files containing either Bill or Sue. 

Bill, Sue;Ted All files containing either Bill and Ted or Sue and Ted. 


Bill “replace disk” All files containing Bill and the phrase “replace disk.” Bill 


can occur before or after the phrase. 


-wa Only the files that do not contain way. 

y y Ly: 
four-way Files that contain four, but do not contain way. 
“four-way” Files containing four-way. 


Looking at a File 
Look lets you view the contents of a file. 


1 Choose File Manager from the File menu, specify the directory you want, then 
choose OK. 


2 Select a file, then choose Look. 


File: C:NUPSINFAX : Revised: 06/23/92 05:G0p 


Conpany: 


Departnent: 


FAX Nunher: Phone: 


Phone: 


Total Pages Sent: » including this cover sheet, 


paa > — — Look at Docunent = 
1 Next 2 Previous 3 Delete 4 Mark 
Scroll Search FZ... 


3 Choose OK when you're finished looking at the file. 
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Looking at a Ale in Hex Mode 


You can view any file in Hexadecimal mode. (Ifa text file is not in WP50, WP51, 
WP52, WP60 or ASCII format, the Look feature will display the file in Hexadecimal 


mode.) 


1 Choose File Manager from the File menu, specify the directory you want, then 


choose OK. 
2 Select a file, chen choose Look Hex. 


8 Choose OK when you're finished looking at the file. 
Copying a File 


You can copy selected files to another directory. If you specify a new filename for the 
copy, you can copy it in the same directory. 


1 Choose File Manager from the File menu, specify the directory you want, then 
choose OK. 


Z Select a file(s) you want, then choose Copy. 


3 To make a duplicate in another directory, type the path and directory in the Copy 
dialog text box, then choose OK. 


or 


To duplicate the file within its original directory, type a new filename, then choose 
OK. 


Moving/Renaming Files 


You can move a single file or all marked files to another directory, but you must rename 
files one at a time. 


1 Choose File Manager from the File menu, specify a directory, then choose OK. 
2 Follow the appropriate steps below. 


Moving or Renaming a Single File 
To move or rename a single file, 


1 Selecta file, then choose Move/Rename. 


2 To move the file, type a different directory in the pathname displayed, then choose 
OK. 


or 


To rename the file, type a new filename, then choose OK. 


If you want to move and rename the file, type both a new directory and a new filename. 


Moving Multiple Files 
To move multiple files, 


1 Use (Un)mark to mark the files you want to move, choose Move/Rename, then 
choose Yes. 

2 Type the directory to which you want to move the files, then choose OK. 

Deleting a File 


Delcte files with caution. Shell cannot recover a deleted file. 


1 Choose File Manager from the File menu, specify a directory, then choose OK. 
2 Select a file, then choose Delete. 

3 Choose Yes if you're sure you want to delete the file. 

Using QuickList 


QuickList lets you access directories that you frequently use. 


Adding Directories to the QuickList 
To add a directory to the QuickList, 


1 Choose File Manager from the File menu, then choose QuickList to open the 
QuickList dialog box. 
er, . aniren TEE IEN. uic. 
The directory path of the ————— Filenane/Directory: canes st 
QuickList name displayed local Macros 


Descriptive names of the ===. 


directories you assign 


2 


Lets you edit the filename pattern 
before displaying File Manager 


Choose Create. 
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Create QuickList Entry 


Filenane/Directory: 


Assign a descriptive name to the 


QuickList directory 
Specify the path of the directory V. 


you are adding to the QuickList 


Filenane/Directory 
WordPerfect Directory C:\UP60 


UP Presentations Directory  C:NPR20 
All UPG Files C:\UP60N\GRAPHICSN\*.UPG 
All UP—-.UPG Files C:MUP6ONGRAPHICSNUP 777 .UPG 


Directory Tree... FO 


3 Type the description (name) you want to use for the QuickList. then specify the full 
path of the directory you want to list. 


4 When you are finished adding the directory information, choose OK to close the 
Create QuickList dialog box. 


The descriptive name is added to the list in the QuickList dialog box. 


Opening a Quicklist 
To open a QuickList, 


1 Choose File Manager from the File menu, then choose QuickList to open the 


QuickList dialog box. 


Z Select the name for the QuickList you want to open, then choose Select. 


Using the Directory Tree 


The Directory Tree represents the directory structure of the current drive. This can be 
especially helpful if you have several levels of directories. You can view all the directories 
on the current drive, or you can view directories on other drives. 


To display the Directory Tree, 


1 Choose File Manager from the File menu, then choose Directory Tree to open the 
Directory Tree dialog box. 


Selecting a Directory 
To select a directory from the current drive, 


1 From the Directory Tree, highlight a directory, then choose Select Directory. 
Switching to Another Drive 


To change drives, 


1 From the Directory Tree, choose Other Drive, highlight a drive letter, then choose 
Select. 


92 Using File Manager 


Rescanning the Current Drive 

The first time you view a drive with Directory Tree, the drive is scanned so that it can be 
correctly represented. When you make changes to the directory structure, you can rescan 
the drive to update the map used to create the Directory Tree. 


1 From the Directory Tree, choose Rescan Drive. 


Setting Up File Manager 
Normally the file list in File Manager is arranged alphabetically by filename, but you can 


arrange it other ways. 
1 Choose File Manager from the File menu, select a directory, then choose OK. 


2 Choose Setup. 


3 Use the options you want, then choose OK (see Sorting the File List earlier in this 
section). 
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Using a Message Board 


The Message Board feature includes a personal and shared message board. Instead of 
writing notes on paper, you can make a quick note to yourself on your personal message 
board. The shared message board is like a public bulletin board for those on a network. 


What's in this section? 


Setting Up Your Message Board(s) 
Organizing Multiple Message Boards 
Creating a Message 

Reading a Message 

Replying to a Message 

Adding a Message 

Artaching Files to a Message 
Deleting a Message 

Saving a Message 

Copying an Attachment 


+ è ù >è o è o + > > 


Setting Up Your Message Board(s) 


Think of a message board as a directory. Posting a message to a message board is like 


saving a file to a directory. When you set up a message board on a network directory, all 
those who can access that directory can use your message board. 


Setting Up Your Personal Message Board 
To set up your personal message board, 


1 Choose Setup from the File menu, then choose Location of Files. 


2 Choose Messages. 


or 


If you are on a network, choose Messages, then select Personal Directory. 


3 Type the directory you want to use as your personal message board (for example, 
c:\messages). 


4 Choose OK. 


If you are creating a new directory, you must verify that you want to create it. 
B Choose OK, then choose Close to return to your Shell desktop. 


Setting Up Your Shared Message Board on a Network 


Ifyou are on a network, you can use the shared message board to post messages to others 
on the network. 


To set up your shared message board, 


1 Choose Setup from the File menu, then choose Location of Files. 


2 Choose Messages, then select Shared Directory. 


3 Type the directory you want to use as your shared message board (for example, 
y:\messages). 


4 Choose OK. 
If you are creating a new directory, you must verify that you want to create it. 
B Choose OK, then choose Close to return to your Shell desktop. 


Setting Up Your Message Board User Name 
To set up your message board user name, 


1 After you have specified a directory for your message board, choose Message Board 


from the Tools menu. 


Shared Message Board 
MESSAGES 


Message Board Directory: U: 


lane—————Sub ject 


1. Read... 
2. Add... 
3. Delete 


4. Save Moy... 
5. Copy Attchant Toggles between message 


S 4 boards 


. Personal Msgs F8 
. Update List FS 


+ Search... FÈ E 
User Manc. pe Updates message list 


E 


= (Unnark 
Hone, "Unnek AL 


This is an example of a message board if you are using Shell on a 
network. 


2 Choose User Name from the options list, type your name, then choose OK. 


If you are on a network, the User Name option sets your user name on both message 


boards. 


3 Choose Close to return to your Shell desktop. 


Organizing Multiple Message Boards 


Like directories, you can organize your message boards so that you can access several sub- 
message boards from a single message board. 
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Creating Sub-Message Board 
To create a sub-message board, 


1 Choose Other Directory from the File menu. 


2 Type the path for a message board adding a directory for the new sub-message board 
(for example c:\messages\ invoices), then choose Yes. 


Invoices becomes a sub-message board of messages. 


Switching Message Boards 


To view another message board, 
1 Choose Message Board from the Tools menu. 


2 Highlight a message board, then choose Read. 


Creating a Message 

To create a message, 

1 Choose New Message from the Tools menu. 
2 Type the subject of the message. 


3 Press Tab, then type the message. (You can press Shift+Tab to return to the subject 
line.) 


4 Choose OK. 


or 


If you are on a network, choose a board on which to post your message, then choose 
OK. 


Your message is posted to the appropriate message board and you are returned to the 
Shell desktop. 


Reading a Message 
To read a message on a message board, 
1 Choose Message Board from the Tools menu. 


2 Ifyou are on a network, choose Personal Msgs/Shared Msgs to toggle to the message 
board that contains the message you want to read. 


8 Select a message, then choose Read. 


While the message is open, you can jump to the previous or next message on the board. 
You can also reply to the message (see Replying to a Message below). 


4 Choose Close to return to the message board. 


Replying to a Message 

To reply to a message you are currently reading, 
1 Choose Reply, then press Tab. 

2 Type the reply message, then choose OK. 


Your reply is now affixed to the message. You can read your reply by choosing List 
Replies (see Reading Replies to a Message below). 


Reading Replies to a Message 
When a message is open, you can read the replies the message has received. 


1 From an open message, choose List Replies. 
2 Select a reply message, then choose Read or press Enter. 


The reply message appears on your screen. While the message is open, you can jump to 
the previous or next reply message on the board. You can also reply to the original 
message (see Replying to a Message above). 


8 Choose Close to return to the Message Reply dialog box. 
If you want to read the rest of the reply messages you can repeat steps 2 and 3. 


4 Choose Close twice to return to the message board. 
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Adding a Message 
To add a message, 


1 Choose Message Board from the Tools menu. 


Personal Message Board 
Message Board Directory: C:\MESSAGES 


Re—————Sub erc 
. Read... 
. Add... 
- Delete 
. Save Msg... 
. Copy Attchant... f 


. Update List FS 


x (Un)nark 
Hone,» (Undnark all 


This is an example of a message board if you are using Shell on a 
stand-alone machine. 


2 


If you are on a network, choose Personal Msgs/Shared Msgs to toggle to the message 
board to which you want your message added. 


8 Choose Add, type the subject of the message, then press Tab. 
4 Type the message. 
5 Choose OK. 


Attaching Files to a Message 


To attach a file to a message, 


1 Follow steps 1 through 4 in Adding a Message above. 
2 


Press Tab to move the cursor to Attachment, then press Enter. 


8 Type the filename of the file you want to attach to the message. 
or 


Choose File List, select the appropriate file, then choose Select. 


4 Choose OK to return to the Message Board. 


Reading Attached Files 


When a message is open, you can read the attached files. 
1 From an open message, choose View from the Attachment box. 
You can use Scroll and Search (as well as the arrow keys) to move around in the file. 


2 Choose Close twice to return to the message board. 


Deleting a Message 
To delete a message, 
1 Choose Message Board from the Tools menu. 


2 If you are on a network, choose Personal Msgs/Shared Msgs to toggle to the message 
board from which you want your message deleted. 


8 Select the message you want to delete. 
4 Choose Delete, then choose Yes to verify that you want to delete the message. 


If you delete a message that has replies attached to it, you will be prompted to verify thar 
you want to delete all the reply messages with the original message. 


Saving a Message 
To save a message, 
1 Choose Message Board from the Tools menu. 


2 If you are on a network, choose Personal Msgs/Shared Msgs to toggle to the message 
board that contains the message you want to save. 


3 Select the message you want to save. 


4 Choose Save Msg, then type the path and filename of the message if it is not already 
displayed correctly. (You can also transfer the message to a clipboard. See Using 
Clipboards larer in this guide for more information on clipboards.) 


B Select Save as Text or Save as a WordPerfect 6.0 document. 
6 Choose OK. 


If the file already exists, you will be prompted to replace or append to it. 
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Copying an Attachment 


To copy (save) an attachment, 


1 
2 


5 


Choose Message Board from the Tools menu. 


If you are on a network, choose Personal/Shared Msgs to toggle to the message board 
that contains the message you want to save. 


Select the message that has the attachment you want to save. 


Choose Copy Attchmnt, then type the path and filename of the attachment if it ts 


not already typed correctly. (You can also transfer the attachment to a clipboard. See 
Using Clipboards later in this guide for more information.) 


Choose OK. 


If the file already exists, you will be prompted to replace it. 


Using Cliphoards 


Clipboards are tools you can use to temporarily store information. You can retrieve a 
clipboard’s contents at another location in the current program or switch programs and 
retrieve the information into a different program. 


The Shell 4.0 Clipboard feature is file-based, Rather than storing information in a 
memory buffer, you can copy the information to its own temporary file. You can create 
as many as 80 clipboards. You no longer have to write over the contents of the current 
clipboard to use the Clipboard feature—simply copy the information to its own clipboard 
file. All clipboard files are deleted when you exit Shell. 


What’s in this section? 
* Using the Clipboard Feature 
* Saving/Appending with Screen Copy 
* Pasting from a Clipboard 
* Viewing a Clipboard’s Contents 


Using the Clipboard Feature 


You can access a clipboard using the Shell feature in Shell-aware programs or the Screen 
Copy and Screen Paste features in programs that are not Shell-aware. (If you do not have 
DOS 3.1 or higher, Screen Copy may not work correctly.) 


IMPORTANT: You must have ELD_CLIPEXE in the same directory where your 
SHELL.EXE resides to use this feature. 


Using the Shell Feature 

Shell-aware programs include Shell options for using a clipboard. The Shell keystroke 
reveals available Shell feature options. The Save and Retrieve options let you save to or 
retrieve from a clipboard. Shell 4.0-aware programs also have a Clipboard Number 
option that lets you choose which clipboard to use. In programs that are not Shell 4.0- 
aware, you can choose a clipboard number using Screen Copy (see Saving/Appending with 
Screen Copy later in this section). 


You can save text to a clipboard using the Shell feature. 
1 Select (block) the text that you want saved to a clipboard. 


2 Dress the Shell keystroke defined by your program (Ctrl+F1 in WordPerfect 
Corporation programs). 


3 Select Save to save selected text to a clipboard. 


You can now switch to another program and use Shell to retrieve text from that 


clipboard. 
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Using Clipboards 


4 Press Switch Program (Ctrl+Alt+x, where x is the hotkey for the program or option 
you want to switch to). 


5 Position the insertion point where you want the Clipboard contents inserted. 


6 Press the Shell keystroke (Crrl+F1), then select Retrieve to insert the Clipboard 


contents. 


For more information about using the Shell feature, refer to the manuel tor the 
WordPerfect Corporation program Sheil is bundled with. 


Saving/Appending with Screen Copy 


Screen Copy lets you transfer a block of text to a clipboard from an; program running in 
text screen mode under Shell. This feature is designed primarily for use with programs 
that do not have a Shell feature, and from parts of Shell-aware programs that cannot 
directly access a clipboard. You can save up to one complete screen at a time to a 


clipboard with Screen Copy. 


To save or append text to a clipboard (or to a Shell macro variable) using Screen Copy, 
1 Press Screen Copy (Ctrl+Alt+F1) from any program running under Shell. 
2 Choose Num, type the number of the clipboard you want to use, then press Enter. 


3 Select Rect to copy a rectangular-shaped block of text, including borders and display 
attributes. 


or 


Select Block to copy an irregular-shaped block of text, such as a sentence within a 


paragraph. If you select block, you cannot block border characters (ASCII characters 
176 through 223). 


IMPORTANT: If you have a Hercules graphics card in your computer and you have 
selected six or twelve fonts for display, not all display attributes will be copied correctly 


with Screen Copy. Also, the text may not appear in reverse video as you move the 
insertion point. 


4 Move the cursor to the beginning of the text you want to copy, then press Enter to 
anchor the beginning of the rectangle or block. 


The cursor doubles in height. 
B Move the cursor to the end of the text you want to copy. 


As you move the cursor, the text is displayed in reverse video. If you select Block, you 
cannot move the cursor over border characters. 


B Dress Enter to finish defining the rectangle or block. 


7 Select Format. 
8 Select Hard Return to insert a Hard Return (CR/LF) code at the end of each line of 
text. This is the default Format option. 
or 
Select Soft Return to insert a Soft Return at the end of each line of text. 
or 


Select Merge Return to save the text in WordPerfect merge file format. An End-of- 
Field merge character code (AR) is inserted at the end of each line, and an End-of- 
Record code (^E) is inserted at the end of the text. 


or 
Select None to save the text without any codes separating each line. 
The option you select becomes the new default setting for the Format option until you 
change it again or exit Shell. 
9 Select Save to save the selected text to a clipboard. 
or 
Select Append to append the selected text to the end of a clipboard. 
or 


Select Macro Variable, then enter the variable number (0-9) or name to save the 
selected text (as many as 130 characters) to that variable. Do not include a tilde (-) 
in the text you save to the variable. 


Pasting from a Clipboard 


Screen Paste lets you retrieve the contents of a clipboard into any program running under 
Shell. (Screen Copy requires a text mode program; Screen Paste does not.) All 
formatting characters are removed, and text is retrieved one character at a time in a 
continuous string. You can format text retrieved with Screen Retrieve using an End of 
Line macro. See Defining (Creating) a Shell Macro in Using Shell Macros later in this 


guide for more information. 

To use Screen Paste with any program running under Shell, including DOS, 

1 Position the cursor where you want the contents of a clipboard inserted. 

2 Press Screen Copy (Ctrl+Alt+F1), then choose Paste. 

Because the Shell Retrieve option retains formatting characters, you should usually use ic 


instead of Screen Paste to retrieve text into WordPerfect Corporation programs (see Using 
the Shell Feature earlier in this section). 
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Viewing a Clipboard's Contents 
You can view and manage the contents of a clipboard with the Clipboard feature. 
1 Go to the Shell desktop, then choose Clipboard from the File menu. 


2 Select Number, type the number of the clipboard you want to view (0-79), then press 
Enter. 


This is not an editing screen, but you can scroll through the disploved text using the up or 
down arrow keys and PgUp (Page Up) or PgDn (Page Down). You can also select Scroll 
to move quickly up or down through the text, or select Search to find « specific word or 


phrase. 


If you want to view but not manage the contents of a clipboard, choose Cancel to return 


to the Shell desktop. 
To manage the contents of a clipboard, 


3 Select Clear, then choose Yes to clear (delete) the contents of the current clipboard. 


or 


Select Save, type a filename, then choose OK. 


Clipboard Save 


Clipboard Format: WordPerfect 5.1 


i 


[ 1] Save as Text 


Prite List G Ra Pe cancer | 


You can save a clipboard’s contents in its current format (including .WPG formar), 
or, if it is not already in text format, you can save it as text by selecting Save as Text. 


or 


Select Retrieve, type the full pathname of the DOS text file you want to retrieve, then 
choose OK. 


Clipboard Retrieve 


pric hist UDIT Pek cer? 


You can also use File List to retrieve a file to a clipboard. See Using File List below. 


You can retrieve binary, WordPerfect 5.x, WordPerfect 6.0, .WPG, or DOS text files 
into a clipboard from this screen. 


The current directory 


If you retrieve a file to the current clipboard, you are prompted to verify that you 
want to replace the contents of the clipboard. You can also retrieve to another 


clipboard to avoid replacing the current clipboard's contents. 


IMPORTANT: You will not be able to view any graphics saved to the clipboard, nor can 


you convert graphic or binary data stored in the clipboard. 
4 Press Exit to return to the Shell desktop. 


Using File List 
File List helps you quickly find and select files. 


1 Choose File List from the Clipboard Retrieve dialog box. 
2 Choose OK. 


or 


Type a directory, then choose OK. 


SS File List 


Dir: C:\SHELL\©.* 
Z | You can select a file. 

m You can change to another 
ELD_CLIP.EXE ; 

ELD_SCRN .EXE . Select director). 


1 

2. Directory 

3. File Manager... FS 
4 

H 


. Use as Pattern You can search for word and file 


gias e patterns. 
Use Name Search to quickly find 


a file. 
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Using the Shell Macro feature, you can record keystrokes or commands for a certain task, 
then later execute the macro to have Shell perform those keystrokes or commands for you. 


You can automate virtually any cask that you can perform manually from Shell or froma 
program running under Shell. 


The Shell Macro feature includes Keystroke (.KBM) and Advan cd (SHM) macros. 
Keystroke macros are simple record-and-playback macros that memorize the keystrokes 
you enter. Keystroke macros can be created directly under Shel! and do not require any 
additional memory. You can also use Advanced macros to record and-play back 


keystrokes. In addition, you can use them with advanced macro commands and variables 
to create complex macros. 


IMPORTANT: You must load the macro engine when you start Shell if you want to use 


Advanced macros. For more information on loading the macro engine, see Starting Shel 
in Getting Started earlier in this guide. 


Advanced macros have similar functionality as the Shell 3.x macros. To edit Advanced 

macros, you need WordPerfect Editor 3.0 (or later). WordPerfect Editor is included with 
Sheli. Some Shell 3.x macro commands and variables are not supported by Shell 4.0. For 
information about Advanced macro commands and variables that are new to Shell 4.0 or 


updated from Shell 3.x, see SHELLMAC.TXT in the same directory as SHELL.EXE. 
Whar’s in this section? 


* Defining (Creating) a Shell Macro 
* Executing (Playing) a Shell Macro 
* Canceling a Shell Macro 

* Editing a Shell Advanced Macro 

* Updating a Shell 3.x Macro 


Defining (Creating) a Shell Macro 


You can define a Shell macro while in Shell or in any program running under Shell unless 
Disable Sheil Hotkeys is set for that program (see Execution Options under Program 
Definition Options in Entering Program Information earlier in this guide). 


To define a Shell macro, 


1 Choose Macros from the Shell Tools menu. (You can also press Ctrl+Alt+F10 from 
Shell or any program running under Shell.) 


Shel] Macros 


o 
1. Play Z. Fecord 1. Edit 


4. Type: (hdvanced (.SHM) 31 


2 Ifyou have the macro engine loaded, choose Type, select the type of macro you want 
to define, then press Enter. 


If you cannot select Type, you do not have the macro engine loaded (see Loading the 
Macro Engine under Starting Shell in Getting Started earlier in this guide). 


3 Choose Record, then type a pathname for the macro. 


or 


Choose Record, choose ALTSHFT, then choose a letter from A to Z. 


4 Choose OK. 


B Type a description for the macro that will remind you what the macro does, then 


choose OK. 
or 


Choose OK to bypass entering a description. 


If you are at the Shell desktop when you start recording the macro, the “Macro Define” 
message is displayed at the top left corner of your Shell screen until you finish defining 


the macro. 
6 Dress the keystrokes you want recorded in the macro. 
7 Press Define Shell Macro (Crrl+Alt+F10) again to end the macro definition. 


If you defined an Advanced macro, you can edit the macro in Editor. See Editing a Shell 
Advanced Macro later in this section. 


Naming a Shell Macro 
Shell uses the name you give plus a .KBM or .SHM extension to create the filename for 


the macro. For example, if you define a keystroke macro and type print as the macro 
name, the filename for the macro will be PRINT.KBM; if you choose AltShft and type p 
for the macro name, the filename will be ALTSHFTP.KBM. 


Saving a Shell Macro 
When you finish defining a Shell macro, the macro file is automatically saved to one of 


several directories, as explained below. 


Program Macro Directory * Shell macros created from within a program running 
under Shell are saved to the macro directory you specify when adding that program to 
a menu. The Program Macro directory can be unique to each program. As a result, 
you can assign the same name to several Shell macros (one in each program). For 
more information about specifying a program macro directory, see Editing the 
Program Definition in Entering Program Information earlier in this guide. 


If you did not specify a macro directory for the program, the macro is saved to the 
Local Macros Files directory specified in Location of Files in Setup. 
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Local Macro Files Directory + Shell macros created from the Shell desktop are saved 
to the Local Macro Files directory specified in Location of Files under Setup. The 
Local Macro Files directory is, by default, the same directory where SHELL.EXE is 
stored, unless you specify a different location. 


System Macro Files Directory * System administrators can use the System Macro 
Files directory to store macros that all nerwork users need to access. Ifyou want to 


save a Shell macro to the System Macros Directory, you must specify the path when 
you type the macro name. 


Specific Macro Directory * You can override the default macro locations for named 
macros by including a full pathname when naming the macro (toi example, 
c:\macros\format). 


If a macro with the same filename already exists in the destination: directory, Shell asks if 
you want to replace the original macro. Type r to replace the original and continue 
defining the new macro, or type e to edit Advanced macros in Editor, or select Cancel to 
return to the Shell Macros dialog box. 


Executing (Playing) a Shell Macro 


The way you execute (play) a Shell macro depends on how you named the macro. 
Named Macro 


If you named the macro with characters, 


1 Choose Macros from the Shell Tools menu. (You can also press Ctrl+Alt+F10 from 
Shell or any program running under Shell.) 


2 Ifyou have the macro engine loaded, choose Type, select the type of macro you want 
to execute, then press Enter. 


If you cannot select Type, you do not have the macro engine loaded (see Loading the 
Macro Engine under Starting Shellin Getting Started earlier in this guide). 


3 Choose Play, then type the macro name. 


or 


Choose Play, choose ALTSHFT, then choose the letter assigned to the macro. 
4 Choose OK. 


Alt+Shilt Macro 


To start a macro named with the Alt+Shift keystroke, simply press Alt+Shift+x (where x is 
the character you used to name the macro). 


IMPORTANT: When you execute a Shell macro, make sure you are in the same location 
(same program and state) as you were when you defined the macro. This helps to ensure 
that the macro does what you want it to do. 


Using List Macros 
If you forget the name of the macro you want to play, you can use List Macros to find it. 


1 Refer to steps 1 and 2 under Named Macro above. 
2 Choose Play, then choose List Macros. 
3 Type the directory where the macro is stored, then choose OK. 


You can also choose Directory Tree to quickly locate the macro files in a particular 
directory, or Macro Directories to select either your Local or System macro directory. 


4 Highlight a macro, choose Select, then choose OK to play the macro. 


Canceling a Shell Macro 
You can cancel a Shell macro in progress by pressing one of three keys. 


1 If you have not pressed any keys since starting che macro, press Esc to stop the macro. 
or 
If you have pressed other keys, press Cancel Macro (Alc+Shift+F 1) or Shell Macro 
(Alt+Shift+F10). 

Editing a Shell Advanced Macro 


You can edit an Advanced macro by retrieving it into WordPerfect Editor (Editor). 
Before you can use Editor to edit Advanced macros, the ED.EXE file must be in the same 
directory as the SHELL.EXE file. (Keystroke [.KBM] macros cannot be edited.) 


To retrieve and edit an advanced macro, 


1 Choose Macros from the Shell Tools menu, then ensure that the Advanced macro 


type (.SHM) is selected. 


2 Choose Edit, then type the macro name. 
or 


Choose Edit, choose ALTSHFT, then choose the letter assigned to the macro. 
3 Choose OK. 
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4 Use any of the cursor movement and editing keys to edit the macro. You can also 
insert keystroke commands and programming commands. See Keystroke Commands 
and Programming Commands below. 


When editing a macro file, macro commands are treated as single characters. For 
example, if the cursor is on a macro command when you press Delete (Del), the entire 
command is deleted. 


B When you finish editing the macro, press Exit, then type y to save the file. 


6 Dress Enter, then type y to replace the original macro file. 


or 


Type a new filename if you want to preserve the original. 
You don’t need to include the filename extension. 
7 Type y to exit Editor. 


Keystroke Commands 
You can insert keystrokes in an Advanced macro. 


Inserting Keystroke Commands Individually + To insert a keystroke command, 
1 Press Value (Ctrl+v), then press the desired key. 


When you press the key, either the key or the name of the feature accessed by the key 
you pressed appears in braces (such as {F10} or {Save}), depending on the editing 


mode you are in. When you are in Shell editing mode, the keystroke appears (for 
example, (F10)). 


Inserting Several Commands Using the Functions Mode + To insert several 
keystroke commands, turn on the Functions mode instead of pressing Ctrl+v. 


1 Press Functions (Ctrl+F10) to turn on the Functions mode. 
Z Press the keystrokes you want to insert into the macro. 


3 Press Functions again to turn off the Functions mode and restore the normal 
Editor functions. 


Programming Commands 


Programming commands appear in all uppercase letters and are enclosed in braces (for 
example, {IF} and {DISPLAY OFF}). You cannot simply type the name of a macro 
command surrounded by braces in the editing screen—you must retrieve the command 
from the Macro Commands list. 


To insert a programming command, 


1 Move the cursor to where you want the command inserted. 


2 ress Macro Commands (Ctrl+PgUp) to display the list of programming commands 
available for the current editing mode. 


3 Move the cursor to the desired command, then press Enter to insert the command. 


You can move to a command by typing the name of the command; you do not need to 
type a brace. 


For an explanation of the programming commands available in WordPerfect and other 
WordPerfect Corporation products, see the reference manual for that program. 


Additional Documentation for WordPerfect Editor 
You can press Help (F3) from within WordPerfect Editor for additional help. 


‘To order a complete WordPerfect Editor manual, contact: 


ORDERS DEPARTMENT 
WORDPERFECT CORPORATION 
1555 N TECHNOLOGY WAY 
OREM UT 84057-2399 

(800) 321-4566 

(801) 226-6800 


Updating a Shell 3.x Macro 


Some Shell 3.x macro commands have been updated. In addition, Shell 4.0 includes new 
macro commands not available in Shell 3.x. As a result, you may need to update your 
Shell 3.x macro before it is totally compatible with Shell 4.0. See the SHELLMAC.TXT 
file included in the same directory as SHELL.EXE for more information about the new 
Shell 4.0 macro commands. 


To update a Shell 3.x macro, 
1 Retrieve a 3.x macro into the Editor that came with Shell 4.0. 


2 Verify har all the commands and variables are supported by Shell 4.0 (see the 
SHELL.MAC readme file for more information). 


3 Update the commands and variables. 


IMPORTANT: If you save a Shell 3.x macro in Shell 4.0, you will not be able to use the 
macro again in Shell 3.x. However, if you simply retrieve and execute a Shell 3.x macro 
in Shell 4.0 without saving it, the macro will retain its Shell 3.x compatibility. 


4 Save and replace the macro, then exit Editor. 
or 


Save the macro with another name to preserve the original macro, then exit Editor. 
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When you press the wrong key, or when other problems arise, an error message dialog 
box may appear on your screen. 


If you encounter a message you do not understand and that message is not listed here, it 
could be a DOS error message, or if you are on a network, a network error message. 


Check your DOS manual or talk to your system administrator for an explanation of these 
messages. 


If you get an error message while running a program from Shell, be sure to check both the 
error messages for the program and for Shell. 


Shell Error Messages 


Many Shell error messages are self-explanatory; however, this section includes those 
messages that may need more explanation. 


Cannot create more than 16 levels 
You cannot have more than 16 levels of submenus. 


Cannot delete a menu that contains active programs 


You attempted to delete/cut a menu containing a program that is currently resident. You 
must exit the resident program(s) before you attempt to delete the menu. 


Cannot install the... (for example, windows\TSR\overlay\device\ELD) 
You attempted to add a program that cannot run under Shell. 


Cannot modify or delete an active program 


You cannot modify or delete a program entry that is resident. You must exit the program 
before you can change its menu entry. 


Cannot remove a file that contains active programs l 
You cannot remove a menu file from the menu files list if it contains any program entries 


that are currently resident. You must exit the resident programs from that file before you 
can remove the menu file. 


Can't transfer control 


There is not enough disk space, expanded memory, or extended memory to hotkey from 
the current program. You need to free up some extended memory, expanded memory, or 
disk space and then try hotkeying out of the program again. 


Directory listing exceeds the buffer limit 
The DOS parh expands to a size greater than allowed in list programs. 


Entry is required 


You must enter a filename pattern when adding a QuickList entry. 


Insufficient cache memory 
Use the /w startup option to increase work space or install more expanded or extended memory. 


Insufficient rights to create a message 
You attempted to create a message and the message board directories are read only. 


No search directories selected 
You attempted to perform a search after selecting “Other” and adding no directories. 


Pasting will create more than 16 levels 
You cannot paste in the selected location because the result would create more than 16 


levels of submenus. 


Program not found 
The program name is not in the path. You must add the full path to the filename field or 


the default directory field in the Define Program dialog box. 


Resulting command line options are too long 
Your command line options are too long. This error can also result from marking the 3.0 
compatibility box in Program Definition (Advanced Options). 


Shell requires at least one menu file 
In Menu Files list you cannot remove all files. You receive this error message if you 
attempt to exit Menu Files list with O files in the list. 


Too many directories listed 
There are too many directories or the length of the total exceeds buffer size. 


Unable to create batch file needed to run program 
There isn’t enough memory in Shell or the directory for temporary files to create the 
batch file needed to run the specified program. 


Unable to open file 
Shell cannot find the menu file you specified. Add the menu file to the Menu Files list. 


Other Error Messages 


The following error message might appear when you are running Shell under Microsoft 
Windows. 


Cannot install the 386 enhanced mode expanded-memory driver 
Microsoft Windows will not run because Launcher is using expanded memory for 
swapped programs. Start Shell using the /ne startup option to disable expanded memory. 
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One of the most useful functions of Shell is keeping multiple programs resident in 
memory while switching from program to program with a single keystroke (see Switching 
Between Programs in Getting Started earlier in this guide). 


How Shell Uses Memory 


When you start a program, the information necessary to run that program resides in 
conventional memory. When you leave a program resident to switch to another program 
(see Switching Between Programs in Getting Started earlier in this guide), the current 
program is swapped to one of several locations, depending on the current operation mode 
and conditions. 


The information below describes Shell startup options that help you control how Shell 
uses memory. 


Shell uses any available expanded memory, extended memory, hard disk space, and/or 
RAM drive space to swap programs. Shell also supports the Lotus/Intel/ Microsoft (LIM) 
Expanded Memory Specification. 


When swapping to one of these locations, expanded memory, then extended memory (if 
any) is used before hard disk or RAM drive space. 


You can use the /v-pachl [/imJ];path2{4im2] (virtual) startup option to specify the drive or 
drives (a maximum of two) you want Shell to use after it uses all available expanded 
memory or extended memory (for example, SHELL/v-c:\temp[500]). You can also use 
the /ne or /nx startup option if you do not want expanded memory or extended memory 
used. Use the /el-dimit and /xl-limit startup options to limit the amount of expanded and 
extended memory used for swapping. 


Insufficient Memory 
If there is not enough memory to swap a program while operating in any of the modes 
above, the following message is displayed: 


ERROR: Insufficient memory 


You will need to exit one or more resident programs before you start the next one. 


Appendix G: Networking Shell 


Setting up Shell on a network gives multiple users access to the Shell program. You can 
run Shell from the network server or from the hard disks of individual workstations. 


This appendix is for the network supervisor who is responsible for installing and 
maintaining Shell on the nerwork. We assume that you have a basic knowledge of 
networks. Ifyou need basic information about networks, please review your network 
documentation. 


What's in this appendix? 


* Getting Ready to Install Shell 

Installing Shell on a Network 

Granting Rights/Privileges 

Establishing Network-Wide Default Settings 

Setting Up User Workstations 

Using NSHSETUP to Add/Change Master Settings 
Giving Users Access to Network Menus and Message Files 
Using Startup Options 

Troubleshooting 

Getting Additional Help 
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Getting Ready to Install Shell 


Shell is installed with the program that it comes bundled with. Refer to the Networking 
appendix for the program Shell is bundled with for more information about installing 
Shell on a network. 


Understanding Your Software License Agreement 
Whether you are installing to a server or an individual workstation, the total number of 
Shell copies in use should not exceed the number printed on your Certificate of License. 


You should have received the Certificate of License when you purchased Shell with the 
WordPerfect program it is bundled with. The Software License Agreement on the back 
of your Certificate of License explains more about using multiple copies of Shell. 


If your license does not authorize use of enough copies of Shell, contact WordPerfect 
Information Services toll-free at (800) 451-5151 to receive information about purchasing 
additional licenses. If your phone system does not handle toll-free calls, dial (801) 225- 
5000. You can also contact your dealer for additional license prices. 


Checking Rights/Privileges to Installation Drive 
Make sure you have sufficient rights or privileges to the drive on which you are going to 
install Shell. You should be able to copy, rename, write, delete, read, and create files. 
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Installing Shell on a Network 


Your package contains an Installation Program that you should use to install Shell (along 
with the program it is bundled with) on the network. Because the Shell program files are 
in compressed format, you mst use the Installation Program to install them. 


To install Shell on a network, refer to che Networking appendix for the program Shell is 


bundled with. 


Granting Rights/Privileges 


Before Shell is used regularly on the network, you should secure files that are critical to 
the operation of Shell. Secure the directories or files by granting read-only rights, which 
let users use files but prevent them from modifying the files. 


Protecting Directories 
Securing a directory protects all the files within that directory. You can assign rights to 


directories by using a special utility provided by your network, such as the SYSCON 
utility or GRANT command line utility offered by Novell. 


Refer to the Networking appendix for the program Shell is bundled with for information 
about 12 major networks and the rights or privileges Shell users should have. 


Establishing Network-Wide Default Settings 


You can establish network-wide default settings (“master settings”) to give Shell a 
consistent, uniform look. You can decide how much autonomy users have over their own 
settings and can maintain control over several key default settings by using the Network 


Setup Utility (NSHSETUP) provided with Shell (see Using NSHSETUP to Add/Change 
Master Settings \ater in this section). 


Possible Default Settings 


Shell is shipped with predefined default settings; you can edit these settings to fit your 
company’s needs. Shell records default settings in Setup, which you can identify by its 
SET extension. The following lists, which are organized by the settings that each file 

contains, show the most common default settings. 


«SET 

Location of Files pathnames 
* Beep options 

+ Screen attributes 

+ Mouse settings 


Master vs. Personal Setup Files 

There are two types of setup files: master and personal. The master setup file contains 
company-wide default settings and uses the network supervisor initials ({sh) in its 
filename. Personal setup files are defined by the individual user and override the master 
setup file settings for that user only. They include users’ unique initials. For example: 
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Master Setup File 
¢ SH{SH_}.SET 


Personal Setup Files 
+ SHKLC_}.SET 
+ SHKSW_ }.SET 
+ SHGRM_}.SET 
+ SHHEIDI}.SET 
+ SHSHSB_}.SET 


Personal setup files inherit settings from the master setup file che first time a user starts 
Shell, so you should define a master setup file before any users start Shell on the network. 
Otherwise, users will inherit only the default settings that ship with Shell, which may not 
be the settings you would choose. 


There are three ways you can make changes to personal setup files after users have started 


Shell. See Using NSHSETUP to Add/Change Master Settings larer in this section. 


Using Initials Consistently 

To ensure that only one setup file exists for each user, users should use the same initials 
every time they start Shell. The /u startup option can be used in each user’s 
AUTOEXEC.BAT file (or login script for NetWare users) to ensure that Shell starts with 
the same initials every time. See Setting Up User Workstations later in this section. 


Creating the Master Setup File 
To create a master setup file (SH{SH__}.SET), 


1 Type shell/u=(sh at the DOS prompt, then press Enter to start Shell with the {sh 
network supervisor initials. 


Because the master setup file (SH{SH__}.SET) can be created only by starting Shell with 
the {sh network supervisor initials, you must use these initials. If you use other initials, 
such as SETUP. Shell will create a setup file based on those initials (for example, 
SHSETUP}.SET), bur Shell will not recognize it as a master setup file. 


2 Set all the options in Setup that you want to establish as system defaults. 


You can establish system defaults for the Shell Color Scheme, any Environment settings, 
and some directories in Location of Files. 


When you use the shell/u={sh startup option, the Network Administrator option appears 
in the environment dialog box. You can set a password to prevent users from using the 
shell/u={sh startup option. 


3 Choose Network Administrator, then choose Password. 
4 Type a password, press Enter, then type the same password again. 


To prevent users from going to DOS, or from making any changes to the contents of 
their menu windows, 
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5 Select Restrict User Access. 
Location of Files pathnames change frequently on a network because users edit 


pathnames to fit their own needs. However, you should establish some initial pathnames 
to help users get started. 


Use the table below as a guide while you specify Location of Files pathnames. Note that 
some directories do not require Master or User pathnames. 


Location of Files Directory Suggested Setting 


System Macro files Master, User, or none 

Local Macro files User, or none 

Menus Master, User, or none 

Messages Master, User, or none 
Master View File 


To create or modify the master window layout file (SH{SH__}. VE’). 


1 Run Shell in network administrator mode (/u-{sh). 


2 Position the menu windows, then use the Save Layout feature to save the settings to 
che master view file. 


If Save Layout on Exit is set, the setting will be saved when you exit Shell. 


The menu window(s) layout (size and position) saved in network administrator mode 
becomes the default setting(s) of network menu windows for all users. Whenever the 
master view file is changed, the network window settings will change for all users the next 
time they run Shell. The master view file will be saved in the same location as the setup 
files (the program directory or in the /ps-path if one has been specified). 


Master Menu File(s) 


The files included in the menu files list when running in network administrator mode 
determine which menus will be included in the network menu system. This list of files is 
saved in the master view file. Users will not see the network menu filenames in their 
menu files list (unless Shell is started with /nta). 


Setting Up User Workstations 


Before users start Shell from their workstations, you may want to include various startup 


options and other commands in their AUTOEXEC.BAT files (or in login scripts for 
NetWare users). 


After you have included the proper commands in the users’ AUTOEXEC.BAT files 


and/or login scripts, all users must restart their computers to put settings into effect. 
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AUTOEXEC.BAT File 
The information below is an example of the commands you can place in the 
AUTOEXEC.BAT file for networks that do not use a login script or an equivalent batch 


of commands. 


PATH X:\SHELL40 
SET SHELL=/U-HMH/D-X:\HEIDI /nt-x 


Redirection command goes here 


Note that command line options that normally use an equal sign (=) require a hyphen (-) 
when included in a DOS SET command. For example, use /u=hmh from the command 
line, but /u-hmh in a DOS SET command. 


See Using Startup Options later in this section for more information. 


Novell Login Script 
The following is an example of what to include in the Novell system login script: 


DOS SET SH="/U-%LOGIN_NAME/D-X:\%LOGIN_NAME /nt-1" 
You must use uppercase letters for all variables, such as the %LOGIN_NAME. You must 


also use the quotation marks (") as shown in the example above. 


Shell reads the first five characters of the %LOGIN_NAME when it is used with the /u 
startup option. You should use a unique set of characters to represent the user (such as 
user’s initials) in login scripts to differentiate between users with similar names. You do 
not need to use all five characters, but having five available will help you to avoid 
requiring two users with similar names to share the same setup file. 


Using NSHSETUP to Add/Change Master Settings 


Users inherit the settings found in the master setup file (SH{SH__}.SET) the first time 
they start Shell if a personal setup file is not present. This is why you should establish 
network-wide or master settings before any users start Shell. See Establishing Network- 
Wide Default Settings earlier in this section. If master settings change after users have 
created their own setup files, there are three ways to update users’ setup files with the new 
settings: 

+ Start Shell with each user's initials and make changes to each user's setup file. This 

could be very time-consuming, especially in a large organization. 


+ Delete all users’ setup files, and have users restart Shell to inherit che latest master 
setup changes. This option erases users’ unique settings. 


* Use the Network Setup Utility (NSHSETUP) provided with Shell to update the 


users’ settings. 


NSHSETUP and SH{SH__}.SET must be in the same directory you have specified with 
the /ps startup option in the Shell environment file (SH{SH__}.ENV) or in the PATH 
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statement. You should use NSHSETUP after you have made changes to the master setup 


file (SH{SH}.SET). See Establishing Network-Wide Default Settings earlier in this section. 
To use NSHSETUP, 

1 Make sure all users have exited Shell. 

If users are still in Shell when you run NSHSETUP. their setup files may not be updated. 


2 Verify that the master setup file (SH{SH__}.SET), the NSHSETUP utility, and all 
users’ personal setup files (SHxxxxx}.SET) exist in the same directory. 


3 Make a copy of all setup files in case you change settings you do not intend to 
update. 


4 AtaDOS prompt, change to the setup file directory. 
B Type nshsetup and press Enter. 


6 Choose Select SET File Group to Update, create a group, type the group name, 
select the appropriate SET files, choose OK, then choose Select. 


or 


Choose Select SET File Group to Update, then select a group. 
7 Choose Select Master SET File, select the appropriate options, then choose Select. 


8 Choose Select Setup Options to Update, select the appropriate options, then choose 
OK. 


9 Choose Update SET Files, then choose Yes. 
or 


Choose Exit if you want to return to DOS without saving any changes. 


The NSHSETUP utility replaces the information in the individual user setup files with 
the information in the master setup file. 


Giving Users Access to Network Menus and Message Files 
The advantage of sharing the menus and message files is that it saves disk space. 


Users should have read-only rights (or equivalent) to the directory that contains the main 
menu files. This allows users to use the files without corrupting them. You may also 
want to secure the menu by “attribing” the file +R (on Novell networks, flagging the file 
SRO). The pathname to the menu should be global; that is, it should be a network 


directory all users have access to. 


To change pathnames in the master setup file (SH{SH__}.SET) and users’ personal setup 
files, 
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1 Type shell/u={sh at the DOS prompt, then press Enter to start Shell. 

Choose Setup from the File menu. 

Choose Location of Files. 

Specify a directory pathname for the menus and messages directory, then choose OK. 


Exit Shell without saving. 
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Run the NSHSETUP utility to replace user setup file settings with the new master 
setup file settings. 


NSHSETUP replaces user setup files with the directory pathnames exactly as they appear 
in Location of Files, even if they are blank. 


Using Startup Options 


Startup options, also known as “switches,” can help Shell work as networked software. 
Some command line options are essential while others are optional. 


What Startup Options Do 

The /nt, /ps, /d, and /u startup options normally use equal signs (=). In a SET 
COMMAND, however, they require a hyphen (-) instead of the equal sign (for example, 
/D-CATEMP instead of /D=C:\TEMP). 


Order of Execution 
The following list shows the order in which startup options are prioritized. 


1. Command line 

2. SH DOS variable 

3. WPC DOS variable 

4. Shell environment file (SH{SH__}.ENV) 


For example, if you start Shell from the command line with /u=FDH (for example, 
shell/u=fdh), yet /u-JFH exists in the SH DOS variable (for example, SET SH=/U-JFH), 
the initials “FDH” are used rather than “JFH.” 


The SH DOS variable is for Shell, whereas WPC is the variable for all WordPerfect DOS 
Products. 


Troubleshooting 
One way to troubleshoot Shell network problems is to narrow the problem by eliminating 
the variables: 

+ Determine whether the problem exists on another networked computer. 

+ Start Shell wich different user initials. 


* Login as the network supervisor. 
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+ Use the /nta startup option. 


L 


Start Shell on a stand-alone machine’s local drive. 


* Unload any TSR programs from CONFIG.SYS or AUTOEXEC.BAT files, or from 
login scripts or batch files. Restart your computer. 
+ Exit Shell and try again. 


If you receive an “Access Denied” message, start Shell with the /d command line 


option to redirect temporary files to a local drive or a drive with all rights (or 
equivalent). 


Refer to the Networking appendix for the program Shell is bundled with for information 
concerning causes and solutions for specific networking problems. 


NETBIOS 
IMPORTANT: NETBIOS must be loaded before you start Sheil. 


Errors When Hotkeying 


If you are hotkeying in and out of DataPerfect and are experiencing a seek error 113, 
create a SHELL.CFG file in the same directory as your NETX.EXE file. The 
SHELL.CFG file should contain: 


Task Mode = 4 


Getting Additional Help 


If, after reading this appendix, you are still having trouble running Shell on a network, 
you can reach WordPerfect Corporation’s Network Support operators by calling 

(801) 228-9902; this is a toll call. You can also fax a description of your problem to the 
Shell Support group at (801) 222-4377. 


Customer Support can help you more easily if you note the keystrokes or procedures that 
caused the problem. You should also be at your computer and refer to this appendix as 
the Customer Support operator helps you. 
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Appendix D: Shell and Editor Files 


Shell and Editor consist of several files. To determine the function of a particular file, 
read the description under the filename. 


Shell Files 


ELD CUP.EXE 
Clipboard file. To use a clipboard, this must be in the same directory as SHELL.EXE. 


ELD_SCRN.EXE 


Screen swapper file. 


FIXWIN.ENE 


Lets you run Windows 3.x from Shell. 


MC.EKE 
Macro Engine file. If you plan to use Shell macros, you must load this file with Shell by 


typing mc shell at che DOS prompt. MC.EXE enables you to record and play Shell 
macros. You can load the macro engine into upper memory if you use the /tsr startup 
option (for example, loadhigh c:\shell40\mc.exe /tsr). 


NSHSETUP.EXE 


Network setup utility. 


NSHSETUP.AL 
Overlay file for NSHSETUP utility. 


NSHSETUP.ICO 
Windows icon for NSHSETUP utility. 


README.SHL 


Contains updated information about WordPerfect Shell. 


SH.MRS 
Macro resource file for Shell macros. SH.MRS is needed to record Shell macros and 


needed by Editor to edit the macros. 


SH40.PIF 
PIF file to allow use of upper memory. 


SHELL.COM 
Launcher file. It must be in the same directory as SHELL.EXE. SHELL.COM helps 


Shell to load into memory. 
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SHELL.EXE 


Main Shell file. You must either start Shell from the directory where SHELL.EXE is 
located, or you must include the directory where SHELL.EXE is located in a DOS PATH 


command. 


SHAL.ICO 
Windows icon for Shell. 
SHAL.OVL 


Contains the overlayed part of the Shell code. For information on redirecting this file to 


expanded memory, see /rin Appendix E: Shell Startup Options. 
SHELLDOS.COM 


Lets you return to Shell after you have gone to DOS from a program. while leaving the 
program resident. 


SHELLMAC.TXT 


Contains the information about new macro commands and Shell 3.x macro commands 
that have been updated. 


SHL_CMP.EXE 


Shell 3.0 compatibility file. If you are using programs originally designed for use with 
Shell 3.0, this file helps those programs interact correctly with Shell 4.0. You must select 
the Shell 3.0 Compatibility check box in the Options dialog box to use this option. 


STANDARD.IRS 


Mouse driver file. This file is required if you are using a mouse. 


WP_SH_US.DTA 


Program Description file used by List Programs. 


WP_SH_US.TRS 


Text Resource file. It contains text used in menus and dialog boxes. 


WP_SS_US.TRS 
Text resource file for NSHSETUP utility. 


* HIP 
Help files. 
* MNU 


Menu files created by Shell when you set up your menus. Ifon a network, the default 
filename contains your user ID. Ifon a stand-alone machine, the file is named 


SH{SH_}.MNU. 
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* MSG 


When you create a message on a message board, it is stored with this extension. 


* SET 


Stores any changes you make to the default settings. 


* VEW 


Records the placement of the windows and which window is active whenever you make a 
change to the desktop. When you return to Shell from DOS or from a program, the 
.VEW file restores the desktop to how it was when you left. 


Shell Temporary Files 
* BSW 


Program swap file. 


* CHK 
Check file. 


* CLP 


"Temporary Clipboard file. 


* SPC 
Space file. 


* TMN 


‘Temporary menu file. 


“VAM 


Virtual memory file. 


Editor Files 


ED.EXE 
Main Editor file. 


ED.HLP 
Help file for Editor. 


ED.ICO 


Windows icon for Editor. 


ED.MRS 


Editor Macro Resource file. It is needed to record and edit Editor macros. 
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Editor Temporary Files 

*EDX.EDB 

Bottom virtual filename. The x represents the current editing window. 
*EDX.DD 

Deleted text filename. The x represents the current editing window. 
*EDX.DT 

Top virtual filename. The x represents the current editing window. 

* Ec 

Check file. 


“DM 


Temporary macro file. 
* D0 
Temporary print queue file. 


* ÆR 
Default range file. 


* mS 
Space file. 
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Appendix E: Shell Startup Options 


You can use Shell startup options to activate, deactivate, or modify specific functions or 
features when you start Shell. 
What’s in this appendix? 


* Using Startup Options 
* Startup Option Descriptions 


Using Startup Options 


When you use a startup option, type it exactly as the name is given, including any slashes 
(/), commas (,), semicolons (;), or brackets ([]). Italicized words in a startup option name 
represent information you must provide. For example, the /m-macroname.ext (.SHM or 
.KMB) option requires that you specify the name of the macro you want to execute. 


If more than one piece of information (also called an argument) is needed, each item is 
separated by a comma (for example, /ss-rows,cols). If more than one piece of information 
is needed within a single argument, the extra information is enclosed in brackets, and the 
arguments are separated by semicolons. For example, in the /v-path1 [lim 1];path2[/m2] 
option, each argument lets you specify a path to a directory and a limit for use of disk 
space on the drive containing that directory. 


You can use more than one startup option at once and enter the options in any order, 
unless specified otherwise in the individual option descriptions. Though it is not 
necessary, you can include a space between each startup option. 


The sections below explain where you can enter startup options. You can enter most 
startup options from any of these locations. Any restrictions as to where you can use 
startup options are explained in the individual startup descriptions. Where you enter a 
startup option can determine what that option affects and its priority if duplicate startup 
options exist. 


Order of Execution * The following list shows the order in which startup options are 
prioritized. 


1. Command line 

2. SH DOS variable 

3. WPC DOS variable 

4. Shell environment file (SH{SH__}.ENV) 


DOS Command Line 
You can include most startup options when starting Shell from DOS. Enter the program 
name followed by any desired startup options (for example, shell/d-c:\temp). 


Startup options you enter on the DOS command line override any options in the DOS 
SET environment or in the host environment file created by your system administrator. 
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DOS SET Environment 

You can use the DOS SET environment to assign startup options for Shell so you don’t 
have to enter them each time you start Shell. This is especially useful if you always start 
the program from DOS, and don’t want to type the startup options each time you start 


Shell. 


The Shell 4.0 DOS SET environment option command is SH. ‘lo use the SH 


environment option, enter set sh=startup option(s) at the DOS prompt. You can include 
it in your AUTOEXEC.BAT file to have it execute each time you start your computer. 


WPC Environment String 
All WordPerfect Corporation network products look for a WPC (WordPerfect 
Corporation) string in the DOS SET environment and use it if it is found. You can use 


the WPC environment option to enter any startup options you want used by all 
WordPerfect Corporation programs on the network. 


To use the WPC environment option, enter set wpc=startup option(s) at the DOS 
prompt, or enter this command in your AUTOEXEC.BAT file to have it execute each 


time you start your computer. Any startup options in the WPC string not recognized by 
a specific program are ignored by that program. 


AUTOEXEC.BAT File 
If you include the command to start Shell in your AUTOEXEC.BAT file, you can also 
include any desired Shell startup options as part of its command line. 


Startup options you enter in the AUTOEXEC.BAT file as part of the Shell command 


line override all other duplicate options. 


Startup Option Descriptions 


The options you can use when you start Shell are described below. These startup options 
affect only the Shell program. When used on the command line or with the SH 
environment variable, they do not affect any programs running under Shell. 


/ep-number 


This option tells the program to use the code page indicated by number. This overrides 
the code page DOS selects when you start your computer. 


Code pages are character sets you can select for specific languages and language groups. 
For a complete description of code pages and the values that represent specific code pages, 


see your DOS manual. 
/e-path1 [lim T);path2{limZ] 


A program creates temporary files, including overflow files, and saves the files to the 
default directory when you start the program. The /d-path (temporary file directory) 
option redirects temporary files to the directory or RAM drive indicated by path. 
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You can use the /d-path1[/m1];path2[/722] option to specify which disk or disks—a 
maximum of two—you can save temporary files to. You can also specify a limit for each 


disk. 


The drive arguments are optional. However, if you do not include at least one argument, 
the option uses all available disk space on the drive from which you are running Shell. 


‘To specify a drive you want Shell to use for overflow files, type the pathname of a 
directory on that drive (for example, /d-d\overflow). If you want to limit the use of that 
drive, include a limit in kilobytes after the pathname and enclose the limit in brackets (for 
example, /d-d:\overflow[ 500]). The limit for a drive is optional, but you must include the 
pathname. 


The following example uses both arguments: 
/d-d:\overflow{ 500); c:\ 


In this example, the OVERFLOW directory of drive D (a RAM drive) is specified with a 
limit of 500K, and the root directory of drive C (a hard drive) is specified with no limit. 


If you have a RAM drive, redirecting a program's temporary files to the RAM drive will 
make some the program’s features work much faster. 


If you are on a network, you should always use the /d-path option to redirect temporary 
files to a personal network directory, a directory on your hard drive, or a RAM drive. 
This ensures that the program does not attempt to create files in a directory where you do 
not have sufficient network rights. 


/el-limit 
Expanded memory manager (EMM) swapping limit in kilobytes. You can disallow 
EMM swapping by setting the limit to zero. 


The limit value is rounded up to the nearest multiple of 16. 


ih 
Displays all the Shell startup options, but does not start Shell. 


[rlanguage 
Two character language ID. 


fll 
This option prevents Launcher from loading into high memory. 


/m-macroname.ext (.SHM or KBM) 

When you scart a program using this option, the specified macro is executed. If the 
macro is not in the current program directory, be sure to include the full pathname for 
the macro file. 
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imt-number 
Monitor type override. 


Ine 

By default, Shell uses all available expanded memory and disk space for swapping 
programs (leaving a program resident while you start another). To reserve your expanded 
memory for other applications, you can use the /ne (no expanded memory) option to 
prevent Shell from using any expanded memory. Shell will still use available disk space if 
you use the /ne option. 


inf 


If you have screen display problems, such as the screen occasionally going blank, with 
some compatibles and windowing programs, try using the /nf (non-flash version) option 
to correct the problems. 


/nt-x 

The /nt-x (network type) option lets you specify your network type. For x, type the 
number or letter code that represents your network software. For a list of network 
software codes and an explanation of when you might need to use this option, see 
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/nta 

This option puts Shell in network administrator mode without changing the user ID. All 
network administrator options are available in this mode. Any changes made in this 
mode will be made for the one user (changing the nerwork administrator password will 


have no effect on the master password). This option is useful for troubleshooting 
problems experienced by a single user. 


inv 

This option prevents swapping programs to disk (the disk will nor be used as virtual 
memory). 

ink 

This option prevents the use of extended memory. 


Ipe-number of progs 

This option lets you specify the number of program entries to allow resident. By default, 
Shell lets you load nine programs resident at one time (including Shell), but you can 
change this setting with the /pe-number of progs option (valid range = 7 to 40 programs). 


[ps-path 
When you change the default Setup settings in Shell, those changes are saved in a Setup 


file. You can use the /ps-path (path to Setup file) option to have Shell save and 
subsequently look for the Setup file in the directory you specify. 


If you are on a network, you should always use the /ps-path option so you know where 


your Setup file is and can be sure Shell is using the correct Setup file. The .VEW files are 
also stored here. 
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Ip 
Load overlay files. This option can help Shell run faster. 


Ire 
Load overlay files into expanded memory. This option can help Shell run faster. 


/rm 
Removes macro engine from upper memory (see /tsr below). 


IPX 
Load overlay files into extended memory. This option can help Shell run faster. 


/sa 

Shell can run as a network or stand-alone program. Shell either starts in network or 
stand-alone mode, depending on the current environment. The /sa (stand-alone) option 
forces Shell to start in stand-alone mode, even with the /nt-# set in the environment. 


/sh-minutes 
Default screen blanking time-out. 


/ss-rows,cols 
Shell usually detects the screen size automatically. If for some reason it does not (for 
example, if you have a Genius monitor), you can use the /ss-rows,cols (screen size) option 


to set the screen size. 


Asp 
Allows the macro engine to be loaded as a Terminate and Stay Resident program. This 


startup option is valid only for MC.EXE. If you want to load the macro engine into 
upper memory, you can use a utility in addition to this startup option (for example, 
loadhigh c:\shell\mc.exe /tsr). 


/U= XXX 
When running on a network, Shell must know your file ID (usually your initials, but can 
be as many as five characters) in order to find your Setup file and create a unique set of 


temporary files for you. 


IMPORTANT: If you use the /u-xxxxx option, you should also use the /ps-path option to 
redirect your Setup files to a personal network directory or a directory on your hard drive. 
The /ps-path option prevents you from using someone else’s user ID when you use the 
lu-xxxxx option. 


v-path im ;path2[lim2) 
You can use the /v-path] [//];path2[/i2] (virtual mode) option to specify which disk 
or disks—a maximum of two—you want used, and to specify a limit for each disk. 


The drive arguments are optional. However, if you do not include at least one argument, 
the option uses all available disk space on the drive from which you are running Shell. 
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Soll Startup Of 


‘To specify a drive you want Shell to use for program swapping, type the pathname of a directory 
on that drive (for example, lv-aNoverflow). Ifyou want to limit the use of that drive, include a 
limit in kilobytes after the pathname and enclose the limit in brackets (for example. /v- 
d\overflow| 500)). The limit for a drive is optional, but you must include the pathname. 


The following example uses both arguments: 
Iv-d\overflou{ 500);c\ 


In this example, the OVERFLOW directory of drive D (a RAM drive) is specified with a 
limit of 500K, and the root directory of drive C (a hard drive) is specified with no limit. 


/w=kk,kk,kk (conv, emm, xms) 

You can use this option to specify the amount of work space used by Shell and the macro 
engine. Shell generally uses all che conventional memory it can find. up to 250K of 
expanded memory, and up to 6% of extended memory in addition to any swap memory. 
By default, the macro engine uses 5K of memory for work space. 


You may need to decrease Shell’s default work space if, for example, you have limited 
memory for swapping. Reducing Shell’s work space can increase the amount of memory 
available for swapping. 


You may want to increase Shell's default work space if, for example, you have unusually 
large menus. You may also want to increase the work space for the macro engine if you 
need to execute unusually large Advanced macros. 


You can use the /w=kk, kk, kk (work space) option to specify exactly how much 
conventional, expanded, and extended memory should be used by Shell or bv the macro 
engine for work space. Specify the amount of memory in kilobytes. For example, 


me /w- /OK shell /w- 500K 


/ws 
Displays available work space. 


IX 
Disables the default system changes. 


/xi-limit 


Extended memory (XMS) swapping limit in kilobyres. You can disallow XMS swapping 
by setting the limit to zero. 


132 


Instructs Shell to use LIM 32 calls. 
1? 


Displays all the Shell startup options, but docs nor start Shell. 


tion 
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